Google AI Mode Scraper

scraper.aimode は、レンダリングされたHTML、生のURL、詳細な引用データを含むGoogle AI Modeの応答をミラーリングし、地域によって結果がどのように変化するかを監査できるようにします。

リクエスト例

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

ボディパラメータ

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

レスポンスフィールド

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

パラメータ	型	説明
`result_text`	string	回答本文。
`result_md`	string	Markdown形式の回答本文。
`result_html`	string	回答のHTMLバージョン。
`raw_url`	string	元のGoogle AI ModeのURL。
`citations`	array	引用ソース。
`citations.snippet`	string	引用記事のスニペット（抜粋）。
`citations.thumbnail`	string	引用記事のサムネイル画像。
`citations.title`	string	引用タイトル。
`citations.url`	string	引用URL。
`citations.website_name`	string	Webサイト名。
`citations.favicon`	string	Webサイトのファビコン。
`search_result`	array	Googleが参照したオプションの検索結果。
`search_result.snippet`	string	検索結果のスニペット。
`search_result.thumbnail`	string	検索結果のサムネイル画像。
`search_result.title`	string	検索結果のタイトル。
`search_result.url`	string	検索結果のリンク。
`search_result.website_name`	string	検索結果のWebサイト名。
`products`	array	Google AI Modeから返される商品情報。
`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	レビュータイトル。

Gemini Google AI Overview