更新情報新機能

Google AI Modeの対話型の回答も取得します

Google AI Mode
ワイヤレスイヤホンについての Google AI Mode の回答と JSON の結果

選んだ市場からGoogleのAI Modeに質問し、対話型の回答と引用ページを受け取れます。

得られる結果

  • text: AI Modeの回答全文です。多くの場合、AI Overviewより長く詳しい内容です。
  • sources: 回答が引用したページを、URLとタイトル付きで受け取れます。
  • 専用のタスクタイプAIMODE: AI ModeとAI Overviewを別々の面として測定できます。

仕組み

AI ModeはGoogleの対話型検索で、1つの質問に根拠ページへのリンク付きの回答を書き上げます。タスクごとに指定した国からAI Modeに質問し、その市場の人が見るとおりの回答と出典を返します。

AI Modeは比較や推薦の質問に詳しく答え、推薦するブランドを名指しします。AI Overviewと並べて追跡すれば、同じクエリが両方の面でどう扱われるかがわかります。

活用例

  • AI Modeがブランドを挙げる推薦や比較のクエリを追跡できます。
  • 同じクエリでAI ModeとAI Overviewが引用するページを比較できます。

リクエストを送る

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": "AIMODE",
    "payload": {
      "query": "best robot vacuum for pet hair",
      "country": "US"
    }
  }'

リクエストのフィールド

taskTypestring必須
実行するエンジン。CHATGPT や GOOGLE などを指定します。
payload.querystring必須
ユーザーが検索ボックスに入力するとおりに書いた検索クエリ。
payload.countrystring
質問する市場の2文字の国コード。US、KR、JP など。既定値は US。
webhook.urlstring
サーバーの HTTPS アドレス。タスクが完了した瞬間に結果をここへ送ります。
idempotencyKeystring
リクエストに付ける独自の ID。1つのキーはアカウント内で1つのタスクを作るため、再送してもタスクは1つのままです。

レスポンス

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

JSON
{
  "success": true,
  "task": {
    "id": "937d9eb6-4b33-49fd-b164-df8e2911b964",
    "taskType": "AIMODE",
    "status": "COMPLETED",
    "createdAt": "2026-10-02T17:16:57.384Z"
  },
  "credits": { "creditsToCharge": 2, "creditsCharged": 2 },
  "response": {
    "markdown": "The **Dreame X50 Ultra** is the overall **best robot vacuum for pet hair**, offering a massive **20,000Pa of suction** and an anti-tangle dual-brush system specifically designed to prevent pet hair wrap.\n\nWhen shopping for a pet hair-focused robot vacuum, comparing suction power, brush design, and price helps identify the right model for your home and budget.\n\n| Model | Key Pet Hair Features | Approx. Price | Best For |\n| --- | --- | --- | --- |\n| **Dreame X50 Ultra** | 20,000Pa suction, Detangling DuoBrush | ~$900 | Heavy shedding & thick carpets |\n| **Roborock Saros Z70** | 5-axis mechanical arm, ultra-thin 7.98 cm body | ~$1,000 | Moving pet toys & low furniture |\n…",
    "shoppingCards": [
      {
        "position": 1,
        "title": "Dreame X50 Ultra",
        "price": { "raw": "$899.99", "value": 899.99, "currency": "$" },
        "store": "Dreametech",
        "rating": 4.5,
        "reviews": "538"
      }
    ],
    "inlineProducts": [
      {
        "position": 1,
        "title": "Dreame X50 Ultra",
        "productLink": "https://www.google.com/search?ibp=oshop&prds=pvt:hg,…"
      }
    ]
  }
}
task.statusstring
QUEUED、PROCESSING を経て、回答付きの COMPLETED か error 付きの FAILED で終わります。
credits.creditsChargedinteger
完了したタスクに請求されたクレジット。失敗したタスクは0です。
response.textstring
回答のプレーンテキスト。
response.markdownstring
見出し、リスト、表を保った回答。すべての結果に入ります。
response.sourcesarray
回答が引用したページ。エンジンの表示順に position、url、label が入ります。
response.shoppingCardsarray
回答とともに表示された商品カード。商品名、価格、販売店、評価、商品リンク。
response.inlineProductsarray
回答の文中でリンクされた商品名。position と productLink が入ります。

結果を受け取る

リクエストすると 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"

料金

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

ほかの更新

最新情報を受け取る

製品の更新をメールでお届けします。

RSS フィード