Google AI Overview Scraper

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

Request Example

curl 'https://api.scrapeless.com/api/v2/scraper/request' \
--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"
    }
}'

Body Parameters

Parameter	Type	Required	Description
`prompt`	string	Yes	Google AI Overviewに送信するプロンプト。
`country`	string	Yes	国または地域コード。
`shopping`	boolean	No	ショッピングデータを取得するかどうか。デフォルトは `true`。有効にすると、`products` フィールドに商品情報が返されます。
`location`	string	No	地域ターゲティング結果用のGoogle正規ロケーション名（例：New York,New York,United States）。サポートされているすべてのロケーションについては、Googleの地域ターゲットリストを参照してください。`uule` とは排他的です。
`uule`	string	No	正確な地域ターゲティング用の事前エンコード済みGoogle UULE文字列。ロケーション名の代わりに事前に構築されたUULE値がある場合に使用します。`location` とは排他的です。

Response Fields

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

💡 Overviewモードがトリガーされない場合、content と rawtext フィールドの両方が空文字列になります。

💡 Overviewモードをトリガーするには、プロンプトを調整するか、プロンプト内のキーワードがGoogle Overviewの対象範囲に含まれていることを確認してください。

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

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

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

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

Parameter	Type	Description
`content`	string	Markdown形式の回答本文。Overviewモードがトリガーされた場合のみ入力されます。それ以外の場合は空文字列になります。
`rawtext`	string	元の回答データ。Overviewモードがトリガーされた場合のみ入力されます。それ以外の場合は空文字列になります。
`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