更新情報新機能

Google AI Overviewに対応しました

Google AI Overviews
ワイヤレスイヤホンについての Google AI Overview と JSON の結果

検索クエリを送ると、Google AI Overviewと引用ページを、同じページの自然検索結果、関連する質問、関連検索とともに受け取れます。

得られる結果

  • aioverview.textとaioverview.sources: AI Overviewの本文と引用ページです。
  • organicResults: 同じページの通常の検索結果で、順位、タイトル、リンク、スニペットが入ります。
  • Googleが表示した場合はpeopleAlsoAsk、relatedSearches、knowledgeGraph、adsも受け取れます。

仕組み

タスクごとに指定した国からGoogleで検索し、結果ページ全体を読み取ります。AI Overviewを表示するかどうかはGoogleが検索ごとに決め、完了した結果にはそのつど表示の有無が記録されます。表示されればaioverviewに入り、通常の検索結果だけのページではnullになります。

この記録がそのまま指標になります。キーワードセットのうちAI Overviewが表示されたクエリの割合がカバー率で、AI Overviewの中身はGoogleが前面に出すブランドとページを示します。

活用例

  • 対象キーワードのうちAI Overviewが表示される割合を市場ごとに測定できます。
  • 自社ページが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": "GOOGLE",
    "payload": {
      "query": "best wireless earbuds for commuting",
      "country": "US"
    }
  }'

リクエストのフィールド

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

レスポンス

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

JSON
{
  "success": true,
  "task": {
    "id": "310ab45d-209e-4a15-8379-9379ab041d48",
    "taskType": "GOOGLE",
    "status": "COMPLETED",
    "createdAt": "2026-10-02T15:53:21.022Z"
  },
  "credits": { "creditsToCharge": 2, "creditsCharged": 2 },
  "response": {
    "aioverview": {
      "text": "The Anker Soundcore Space A40 is the best wireless earbud for commuting due to its strong adaptive noise cancellation, long battery life, and compact value.",
      "sources": [
        {
          "position": 1,
          "url": "https://www.soundcore.com/products/space-a40-a3936011",
          "label": "Anker Soundcore Space A40"
        },
        {
          "position": 2,
          "url": "https://www.techtimes.com/articles/313618/20260101/best-wireless-bluetooth-earbuds-under-100-are-they-really-worth-price.htm",
          "label": "Tech Times"
        }
      ],
      "shoppingCards": [
        {
          "position": 1,
          "title": "Anker Soundcore Space A40",
          "price": { "raw": "$54.99", "value": 54.99, "currency": "$" },
          "store": "soundcore US",
          "rating": 4.4,
          "reviews": "1.2K"
        }
      ]
    },
    "organicResults": [
      {
        "position": 1,
        "title": "Highest Rated Wireless Earbuds",
        "link": "https://www.amazon.com/Highest-Rated-Wireless-Earbuds/s?k=Highest+Rated+Wireless+Earbuds",
        "snippet": "Soundcore by Anker P20i True Wireless Earbuds, 10mm Drivers with Big Bass, Bluetooth 5.3, 30H Long Playtime, Water-Resistant, 2 Mics for AI Clear Calls, ..."
      }
    ],
    "peopleAlsoAsk": [
      { "question": "What are the best wireless earbuds for office work?" }
    ],
    "relatedSearches": [
      { "query": "Best wireless earbuds for commuting reddit" },
      { "query": "Best wireless earbuds for commuting iphone" }
    ]
  }
}
task.statusstring
QUEUED、PROCESSING を経て、回答付きの COMPLETED か error 付きの FAILED で終わります。
credits.creditsChargedinteger
完了したタスクに請求されたクレジット。失敗したタスクは0です。
response.aioverviewobject
AI による概要の text、sources、リクエスト時の markdown。Google が検索結果だけを表示したクエリは null になります。
response.aioverview.shoppingCardsarray
概要に表示された商品カード。商品名、価格、販売店、評価、レビュー数、商品リンク。
response.organicResultsarray
ページの検索結果。position、title、link、snippet、page。
response.peopleAlsoAskarray
Google がページに表示した関連する質問。
response.relatedSearchesarray
ページ下部の関連検索。

結果を受け取る

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

料金

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

ほかの更新

最新情報を受け取る

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

RSS フィード