Geminiの出典ごとに信頼度が付きます

自分の市場でGeminiアプリが質問にどう答えるかを、回答の根拠となったWebの出典と出典ごとの信頼度とともに受け取れます。

得られる結果

• text: Geminiの回答全文です。リクエストすればmarkdownも受け取れます。
• sources: Geminiが回答の根拠にしたWebページを、URLとタイトル付きで受け取れます。
• 出典ごとのconfidence_level: Geminiがその出典を回答とどれだけ強く結び付けているかを示すため、引用に重み付けできます。

仕組み

タスクごとに指定した国から一般向けGeminiアプリに質問し、その市場の顧客が見る回答を返します。Geminiは自身の知識とWebで見つけた情報を組み合わせて答え、出典リストは回答を裏付けるページを正確に示します。

ChatGPTやPerplexityに送る質問をGeminiにも送れば、エンジンごとに推薦するブランドや信頼するページを比較できます。

活用例

• Geminiが自社ブランドと競合をどう説明しているかを追跡できます。
• 信頼度で引用に重み付けし、自社カテゴリーで最も影響力のある出典を見つけられます。
• 1つの質問セットでGeminiと他のエンジンを比較できます。

リクエストを送る

API キーを Authorization ヘッダーに入れてリクエストを送ります。

curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "taskType": "GEMINI",
    "payload": {
      "prompt": "Search the web and recommend 3 wireless earbuds for commuting. Compare noise cancellation and battery life in a short table, with source links. Keep the answer under 180 words.",
      "country": "US",
      "include": { "markdown": true }
    }
  }'

リクエストのフィールド

taskTypestring必須

実行するエンジン。CHATGPT や GOOGLE などを指定します。

payload.promptstring必須

ユーザーがチャットに入力するとおりに書いた質問。最大100,000文字。

payload.countrystring

質問する市場の2文字の国コード。US、KR、JP など。既定値は US。

payload.locationstring

country 内の場所。駅、地区、住所など最大200文字。エンジンはその場所にいるユーザーへの回答を返します。CHATGPT、GEMINI、GOOGLE、AIMODE、GOOGLE_SERP で使えます。

payload.include.markdownboolean

true にすると、見出し、リスト、表、リンクを保った markdown が加わります。

webhook.urlstring

サーバーの HTTPS アドレス。タスクが完了した瞬間に結果をここへ送ります。

idempotencyKeystring

リクエストに付ける独自の ID。1つのキーはアカウント内で1つのタスクを作るため、再送してもタスクは1つのままです。

レスポンス

完了したタスクはこの形で届きます。長さを抑えて抜粋しています。

{
  "success": true,
  "task": {
    "id": "40b806b8-c057-4003-934e-98ab5fef2cef",
    "taskType": "GEMINI",
    "status": "COMPLETED",
    "createdAt": "2026-09-10T02:34:15.665Z"
  },
  "credits": { "creditsToCharge": 1, "creditsCharged": 1 },
  "response": {
    "markdown": "Here are 3 top wireless earbuds for commuting:\n\n* **[Bose QuietComfort Ultra Wireless Noise Cancelling Earbuds](…)**: The best choice for commuting, offering unmatched noise cancellation to block …\n…",
    "sources": [
      {
        "position": 3,
        "url": "https://google.com/search?q=EarFun+Air+Pro+4+Wireless+In-ear+headphones&…"
      },
      {
        "position": 5,
        "url": "https://google.com/search?q=Anker+Soundcore+Liberty+5+True+Wireless+Bluetooth+Earbuds&…"
      }
    ]
  }
}

task.statusstring

QUEUED、PROCESSING を経て、回答付きの COMPLETED か error 付きの FAILED で終わります。

credits.creditsChargedinteger

完了したタスクに請求されたクレジット。失敗したタスクは0です。

response.textstring

回答のプレーンテキスト。

response.markdownstring

書式を保った回答。見出し、リスト、表、リンクがそのまま入ります。

response.sourcesarray

回答が引用したページ。エンジンの表示順に position、url、label が入ります。

結果を受け取る

リクエストすると status が QUEUED のタスクがすぐに返ります。status が COMPLETED か FAILED になるまで GET /v1/async/task/{id} で取得するか、webhook.url を指定して同じ task、credits、response をサーバーで受け取ります。結果はタスクの完了から24時間取得できます。

curl https://api.querying.ai/v1/async/task/$TASK_ID \
  -H "Authorization: Bearer $QUERYING_API_KEY"

料金

完了したGeminiタスク1件につき1クレジットを使用します。