更新情報改善

Google AI OverviewがMarkdownでも届きます

Google AI Overviews
Markdown で受け取った Google AI Overview と、同じ内容を見出しと表で表示した画面

aioverview.markdownで、Googleが組み立てた見出し、リスト、表をそのまま保ったAI Overviewを取得できます。

変更点

  • aioverview.markdown: AI OverviewをMarkdownで受け取れます。見出し、リスト、表、太字がそのまま残ります。
  • aioverview.textはこれまでどおり同じ文字を返すので、プレーンテキストを読むコードもそのまま動きます。
  • Google AI Modeの回答には、同じ形式のMarkdownが結果ごとにmarkdownとして入ります。

仕組み

GoogleはAI Overviewを見出し、番号付きの手順、箇条書き、比較表で組み立てます。aioverview.textには文字が入り、aioverview.markdownはこの構成も保つため、検索ユーザーが見るとおりに表示したり、コードで構造を読み取ったりできます。引用ページはこれまでどおりaioverview.sourcesにあります。

include.aioverview.markdown: trueで有効になります。ほかのエンジンでも使う共通フラグinclude.markdown: trueでも有効になります。

活用例

  • 自社のダッシュボードやレポートに、AI Overviewを元の書式のまま表示します。
  • AI Overviewの手順、表、比較にGoogleがどのブランドを挙げているかを調べます。
  • AI Overviewをセクションごとに分け、Googleがどのトピックを先に扱うかを確認します。

リクエストを送る

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 robot vacuum for pet hair",
      "country": "US",
      "include": { "markdown": true }
    }
  }'

リクエストのフィールド

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

レスポンス

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

JSON
{
  "success": true,
  "task": {
    "id": "8dcde5b1-2f53-40b3-b048-05075b03c4a9",
    "taskType": "GOOGLE",
    "status": "COMPLETED",
    "createdAt": "2026-10-02T17:16:57.237Z"
  },
  "credits": { "creditsToCharge": 2, "creditsCharged": 2 },
  "response": {
    "aioverview": {
      "text": "The Roborock Saros Z70 and the MOVA V50 are top choices for pet hair, combining powerful suction with specialized anti-tangle brush rollers.",
      "markdown": "The Roborock Saros Z70 and the MOVA V50 are top choices for pet hair, combining powerful suction with specialized anti-tangle brush rollers.\n\n### Top Robot Vacuums for Pet Hair\n\n**Roborock Saros Z70**\n\nNamed a top overall pick by experts for its strong hard-floor pickup, smart obstacle recognition, and self-emptying dock. It costs around $1,000.\n\n**MOVA V50**\n\nPraised as a top performer in dog hair tests and obstacle avoidance. It features a dual brush roller and app controls for auto-emptying frequency, usually priced under $700.\n\n…",
      "sources": [
        {
          "position": 2,
          "url": "https://www.rtings.com/robot-vacuum/reviews/best/pet-hair",
          "label": "RTINGS.com"
        },
        {
          "position": 3,
          "url": "https://www.forbes.com/sites/forbes-personal-shopper/article/best-robot-vacuum-for-pet-hair/",
          "label": "Forbes Vetted"
        }
      ]
    }
  }
}
task.statusstring
QUEUED、PROCESSING を経て、回答付きの COMPLETED か error 付きの FAILED で終わります。
credits.creditsChargedinteger
完了したタスクに請求されたクレジット。失敗したタスクは0です。
response.aioverviewobject
AI による概要の text、sources、リクエスト時の markdown。Google が検索結果だけを表示したクエリは null になります。
response.aioverview.markdownstring
Google の表示どおりの構成で書かれた概要の Markdown。### の見出し、リスト、表、太字。

結果を受け取る

リクエストすると 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クレジットで、Markdownも含まれます。

ほかの更新

最新情報を受け取る

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

RSS フィード