Google AIによる概要 API: 概要テキスト、出典、SERP

GOOGLE は google.com で検索し、AIによる概要を、それが表示された検索結果ページと一緒に返します。


taskType	`GOOGLE`
エイリアス	`GOOGLE_AIO`
読むフィールド	`query`(なければ `prompt`)
クレジット	1.25
国	任意、既定は `US`。`CN` は北京の端末から Google の米国市場に質問します。
位置情報	`payload.location` を受け付けます。地域と位置情報を参照してください。

リクエスト

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 CRM for a small team", "country": "US" } }'

レスポンス

レスポンスは検索結果エンベロープで、AIによる概要はnullableメンバーの1つ aioverview として入ります。

aioverview: null は、そのクエリで Google がAIによる概要を表示しなかったことを意味します。エラーではありません。タスクは完了し、周囲の結果フィールドはそのまま設定されます。

フィールド	型	説明
`aioverview`	object または `null`	AIによる概要。フィールドは下記のとおりです。
`organicResults`	array	自然検索結果。
`peopleAlsoAsk`	array	「他の人はこちらも質問」パネル。
`relatedSearches`	array	関連検索。
`knowledgeGraph`	object	ナレッジパネル。
`ads`	array	上部と下部の広告。
`map`	array	ローカルパック: `name`、`position`、`placeId`、`location`、`mapsUrl`、`reviews`、`category`、`price`、`snippet`、`image`。
`serp`	object	その他のパネル: `topStories`、`videoResults`、`localMap`、`discussionsAndForums`。
`rawContent`	string	レンダリングされた結果ページのHTML。`include.rawResponse` のときのみ。
`text`、`sources`		`aioverview.text` と `aioverview.sources` の非推奨のコピー。新しいコードでは `aioverview.*` を読んでください。

結果パネルはページにない場合、null や [] ではなく省略されます。すべて任意のフィールドとして扱ってください。

`aioverview`

フィールド	型	説明
`text`	string	概要のテキスト。商品カードのタイトルも含まれます。
`sources`	array	`position`、`url`、`label`、`description`。
`markdown`	string	Markdownの概要。`include.markdown` または `include.aioverview.markdown` のときのみ。
`shoppingCards`	array	回答の横に表示される商品タイル: `title`、`position`、`price`、`oldPrice`、`store`、`rating`、`reviews`、`thumbnail`、`productLink`。
`inlineProducts`	array	回答内でリンクされた商品名: `title`、`position`、`productLink`。
`citationPills`	array	各引用チップの裏にある出典を、出典1件につき1項目で。
`videos`	array	概要に表示された動画: `title`、`link`、`platform`、`channel`、`duration`。
`sponsored`	array	概要内のスポンサー項目: `label`、`title`、`advertiser`。

商品、チップ、動画、スポンサーのフィールドは、概要にそれらが表示されたときだけ含まれます。price.currency は表示どおりの記号($、€)、reviews は Google の省略表記(2.3K)のまま、productLink は Google の商品ページです。 citationPills では、同じチップの出典が回答順に振られた citationPillId を共有し、position は対応する aioverview.sources の項目を指します。チップだけが引用するページも、概要が示す出典の後ろに aioverview.sources の項目として入ります。Google がタイトルを表示しない場合、その label は空文字列です。各項目には label、url、domain と、Google が表示する場合は site、description、thumbnail が入ります。レスポンスに markdown がある場合、markdownOffset はその中でのチップの位置を示します。sponsored の項目にも同じように labelOffset、markdownOffset、noteOffset が付きます。例:

{
  "aioverview": {
    "text": "Popular CRMs for small teams include HubSpot CRM and Pipedrive ...",
    "sources": [{ "position": 1, "url": "https://www.example.com/crm-guide" }],
    "citationPills": [
      { "label": "CRM guide for small teams", "citationPillId": 1, "url": "https://www.example.com/crm-guide", "domain": "example.com", "position": 1 }
    ]
  },
  "organicResults": [
    { "position": 1, "title": "The best CRM for small teams", "link": "https://www.example.com/crm-guide", "snippet": "..." }
  ],
  "relatedSearches": [{ "query": "free crm for small team" }],
  "text": "Popular CRMs for small teams include HubSpot CRM and Pipedrive ...",
  "sources": [{ "position": 1, "url": "https://www.example.com/crm-guide" }]
}

includeフラグ

フラグ	効果
`markdown`	`aioverview.markdown` を追加します。`include.aioverview.markdown` も同じです。
`rawResponse`	レンダリングされた結果ページ `rawContent` を追加します。
`html`	結果ページを共有できるファイルとして `html` に追加します。HTMLページを参照してください。
`analysis`	`analysis` を追加します。1クレジット。回答の分析を参照してください。
`citationAnalysis`	概要に対してCitation Analysisを実行します。

searchQueries、ads、shopping は効果がありません。Markdownと生のレスポンスを参照してください。概要なしの自然検索結果を、より速く1クレジットで取得するにはGoogle検索を使ってください。

中国

Google は中国市場にAIによる概要を表示しません。そのため CN タスクは、中国本土の人々が Google にアクセスするのと同じように、北京にある端末から Google の米国市場(gl=us)に質問します。独自の payload.location を指定したタスクは、その位置情報を使います。

はじめに

基本概念

回答エンジン

検索とウェブデータ

リクエストオプション

リサーチ

GEOモニタリング

アカウントとデータ

Google AIによる概要 API: 概要テキスト、出典、SERP

リクエスト

レスポンス

`aioverview`

includeフラグ

中国

関連ページ

​リクエスト

​レスポンス

​aioverview

​includeフラグ

​中国

​関連ページ

リクエスト

レスポンス

`aioverview`

includeフラグ

中国

関連ページ