Google AI Overview スクレーパー

scraper.overview 地域ごとの検索結果を分析するため、強化された製品データ、引用、広告、ウェブ情報源を含む包括的な Google AI Overview レスポンスを取得します。

リクエストの例

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"
    }
}'

ボディパラメータ

パラメータ	型	必須	説明
`prompt`	string	はい	Google AI Overview に送信されたプロンプト。
`country`	string	はい	国または地域コード。
`shopping`	boolean	いいえ	ショッピングデータを取得するかどうか。デフォルトは `true`。有効にすると、レスポンスに `products` フィールド内の追加の製品情報が含まれます。これには、各製品クラスタの背後にある販売店の提供内容（直販ストアのURL、価格、分割払い、在庫、配送、返品など）が含まれます。
`location`	string	いいえ	地理的ターゲティング結果のためのGoogle公式ロケーション名（例：ニューヨーク,ニューヨーク,アメリカ合衆国）。サポートされているすべてのロケーションについては、 Googleのジオターゲットリストを参照してください。uuleとは相互に排他的です。
`uule`	string	いいえ	正確な地理的ターゲティングのための事前エンコードされた Google UULE 文字列。ロケーション名の代わりに事前に作成された UULE 値を使用する場合にこのパラメータを使用します。location と相互に排他的です。
`should_fetch_share_link`	boolean	いいえ	共有リンクを取得します。

レスポンスフィールド

注：設定で shopping を有効にし、レスポンスにこの追加の商品情報が含まれる場合、API呼び出しには 基本料金の2倍が課金されます。これは、複数のソースから商品情報を抽出して処理するために追加のリソースが必要となるためです。

💡 概要モードがトリガーされない場合、 content および rawtext フィールドは空文字列になります。

💡 概要モードをトリガーするには、プロンプトの調整を試みるか、プロンプト内のキーワードがGoogle概要によってカバーされていることを確認してください。

データフィールドのソース： ai概要内のproducts

タイプ	product_position	説明
製品	推奨	推奨製品
製品	inline_link	インラインリンク製品
製品	参照	参照製品
広告製品	null	広告製品群

データフィールドの製品： Google waleスポンサード製品

データフィールドの広告： 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	ウェブサイトのファビコン。
`source.snippet`	string	引用記事の抜粋。
`source.thumbnail`	string	引用記事のカバー画像。
`source.title`	string	引用タイトル。
`source.type`	string	ソースタイプ。
`source.url`	string	引用元のURL。
`source.website_name`	string	ウェブサイト名。
`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_source.favicon`	string	ウェブサイトのファビコン。
`web_source.snippet`	string	引用記事の抜粋。
`web_source.thumbnail`	string	引用記事のカバー画像。
`web_source.title`	string	引用タイトル。
`web_source.url`	string	引用元のURL。
`web_source.website_name`	string	ウェブサイト名。
`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	ウェブサイトリンク。
`ads.site_links.title`	string	タイトル。
`ads.site_links.url`	string	Webページ URL。
`ads.site_links.google_ad_url`	string	広告リンク。
`products`	array	Google Overview モードによって返された製品情報。
`products.thumbnails`	array	商品サムネイル画像URLの配列。
`products.title`	string	製品タイトル。
`products.url`	string	製品ページのURL。
`products.brand`	string	商品ブランド名。
`products.reviews`	int	レビュー件数。
`products.rating`	string	平均評価スコア。
`products.price_range`	string	価格帯の例： `$2,499.99`。
`products.stores`	array	ストアオファーの配列。
`products.stores.name`	string	ストア名。
`products.stores.link`	string	ストアの商品リンク。
`products.stores.title`	string	ストアでの商品タイトル。
`products.stores.ratings`	string	ストア評価の例： `4.3/5`。
`products.stores.extensions`	array	その他の情報（在庫、配送、返品）。
`products.stores.price`	string	ストア価格。
`products.stores.delivery_fee`	string	配送料情報。
`products.stores.total_price`	string	料金を含む合計価格。
`products.about_the_product`	object	詳細な商品情報。
`products.about_the_product.title`	string	セクションタイトル。
`products.about_the_product.link`	string	商品ページリンク。
`products.about_the_product.displayed_link`	string	表示されるドメイン名。
`products.about_the_product.features`	array	商品の特徴／仕様。
`products.about_the_product.features.title`	string	特徴名。
`products.about_the_product.features.value`	string	特徴値。
`products.about_the_product.description`	string	商品説明。
`products.variants`	array	商品バリエーションオプション。
`products.variants.title`	string	バリエーションカテゴリタイトル。
`products.variants.items`	array	バリエーションオプションリスト。
`products.variants.items.name`	string	バリエーションオプション名。
`products.variants.items.selected`	bool	このバリエーションが選択されているかどうか。
`products.variants.items.availability`	bool	バリエーションの利用可能状態。
`products.ratings`	array	評価分布データ。
`products.ratings.stars`	int	星評価レベル（1～5）。
`products.ratings.amount`	int	このレベルの評価件数。
`products.user_reviews`	array	ユーザー口コミデータ。
`products.user_reviews.text`	string	口コミ本文。
`products.user_reviews.source`	string	口コミ掲載プラットフォーム。
`products.user_reviews.rating`	int	ユーザー評価スコア。
`products.user_reviews.date`	string	口コミ日付。
`products.user_reviews.name`	string	レビュアー名。
`products.user_reviews.title`	string	口コミタイトル。
`share_url`	string	共有リンク。

Google AI Mode Grok