Google AI Overview Scraper

scraper.overview は、豊富な商品データ、引用、広告、Web ソースを含む包括的な Google AI Overview のレスポンスを取得し、異なる地域での検索結果の分析を支援します。

リクエスト例

curl '{api_host}/api/v2/scraper/execute' \
--header 'Content-Type: application/json' \
--header 'x-api-token: {you_api_key}' \
--data '{
    "actor": "scraper.overview",
    "input": {
        "prompt": "Recommended attractions in New York",
        "country": "US",
        "shopping": true
    },
    "webhook": {
        "url": "http://www.youwebhook.com"
    }
}'

ボディパラメータ

パラメータ	型	必須	説明
`prompt`	string	はい	Google AI Overview に送信するプロンプト。
`country`	string	はい	国または地域。
`shopping`	boolean	いいえ	ショッピングデータを取得するかどうか。デフォルトは `true`。有効にすると、`products` フィールドに商品情報が返されます。

レスポンスフィールド

注: レスポンスにショッピングデータ（products フィールド）が含まれる場合、API コールは基本料金の 2 倍で課金されます。これは、複数のソースから商品情報を抽出および処理するために追加のリソースオーバーヘッドが必要となるためです。

データフィールド Source: AI Overview 内の商品

type	product_position	description
product	recommended	推奨商品
product	inline_link	インラインリンク商品
product	reference	参照商品
ads product	null	広告商品

データフィールド Products: Google スポンサー商品

データフィールド Ads: Google 広告(Serp)

パラメータ	型	説明
`content`	string	Markdown 形式の回答本文。
`rawtext`	string	元の回答データ。
`metadata`	object	メタデータ情報。
`metadata.rawUrl`	string	Web ページの URL。
`is_overview_shopping`	boolean	ショッピングデータが埋め込まれているかどうか。
`products`	array	商品データ。
`products.delivery`	string	配送サービス。
`products.discount`	string	割引情報。
`products.img`	string	商品画像の URL。
`products.orig_price`	string	元の価格。
`products.rating`	string	評価。
`products.review_count`	string	レビュー数。
`products.seller`	string	販売者。
`products.url`	string	商品詳細ページの URL。
`products.stores`	array	店舗情報。
`products.stores.delivery_fee`	string	配送料。
`products.stores.extensions`	array	追加サービス。
`products.stores.link`	string	商品リダイレクトリンク。
`products.stores.name`	string	店舗名。
`products.stores.price`	string	販売価格。
`products.ratings`	string	評価。
`products.tag`	string	タグ。
`products.title`	string	商品タイトル。
`products.total_price`	string	合計価格。
`source`	array	引用ソース。
`source.favicon`	string	Web サイトのファビコン。
`source.snippet`	string	引用記事のスニペット。
`source.thumbnail`	string	引用記事のサムネイル画像。
`source.title`	string	引用タイトル。
`source.type`	string	ソースタイプ。
`source.url`	string	引用元の URL。
`source.website_name`	string	Web サイト名。
`source.html_index`	int	Markdown コンテンツ内の推奨商品ショッピングカードの位置を示します。
`source.stores`	array	店舗情報。
`source.stores.delivery_fee`	string	配送料。
`source.stores.extensions`	array	追加サービス。
`source.stores.link`	string	商品リダイレクトリンク。
`source.stores.name`	string	店舗名。
`source.stores.price`	string	販売価格。
`web_source`	array	Web 検索ソース。
`web_source.favicon`	string	Web サイトのファビコン。
`web_source.snippet`	string	引用記事のスニペット。
`web_source.thumbnail`	string	引用記事のサムネイル画像。
`web_source.title`	string	引用タイトル。
`web_source.url`	string	引用元の URL。
`web_source.website_name`	string	Web サイト名。
`web_source.stores`	array	店舗情報。
`web_source.stores.delivery_fee`	string	配送料。
`web_source.stores.extensions`	array	追加サービス。
`web_source.stores.link`	string	商品リダイレクトリンク。
`web_source.stores.name`	string	店舗名。
`web_source.stores.price`	string	販売価格。
`ads`	array	広告。
`ads.section_title`	string	セクションタイトル。
`ads.type`	string	タイプ。
`ads.title`	string	タイトル。
`ads.url`	string	Web ページの URL。
`ads.google_ad_url`	string	広告リンク。
`ads.display_url`	string	表示 URL。
`ads.advertiser`	string	広告主。
`ads.description`	string	説明。
`ads.tracking_token`	string	トラッキングトークン。
`ads.slot`	string	広告スロット番号。
`ads.price`	string	価格。
`ads.orig_price`	string	元の価格。
`ads.seller`	string	販売者。
`ads.rating`	string	評価。
`ads.review_count`	string	レビュー数。
`ads.img`	string	商品画像の URL。
`ads.site_links`	array	Web サイトリンク。
`ads.site_links.title`	string	タイトル。
`ads.site_links.url`	string	Web ページの URL。
`ads.site_links.google_ad_url`	string	広告リンク。

Google AI モード Grok