Google AI Mode スクレイパー
scraper.aimode Google AI Mode の応答を、レンダリングされたHTML、生のURL、および詳細な引用データとともにミラーリングするため、結果が地域ごとにどのように異なるかを監査できます。
リクエストの例
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 | はい | 国または地域コード。 |
shopping | boolean | いいえ | ショッピングデータを取得するかどうか。デフォルトは true。有効にすると、レスポンスは products フィールドに追加の商品情報(商品クラスターの背後にある販売業者のオファー、直販店のURL、価格、分割払い、在庫、配送、返品など)を含みます。 |
location | string | いいえ | 地理的ターゲット結果用のGoogle標準ロケーション名(例:New York,New York,United States)。サポートされているすべてのロケーションについては、 Googleのジオターゲットリスト を参照してください。uuleパラメータとは相互に排他的です。 |
uule | string | いいえ | 正確な地理的ターゲティングのための事前エンコードされた Google UULE 文字列。ロケーション名の代わりに事前に作成された UULE 値を使用する場合にこのパラメータを使用します。location と相互に排他的です。 |
url | string | いいえ | Google AIモードの完全なアクセスリンク。 すべての他のパラメータと相互に排他的です。 このパラメータが指定された場合、他のすべてのリクエストパラメータは不要となり、指定されても自動的に無視されます。 |
should_fetch_share_link | boolean | いいえ | 共有リンクを取得します。 |
レスポンスフィールド
注: 設定で
shoppingを有効にし、レスポンスにこの追加の商品情報が含まれる場合、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 | ウェブサイト名。 |
citations.favicon | string | ウェブサイトのファビコン。 |
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 | 検索結果のウェブサイト名。 |
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 | 口コミタイトル。 |
share_url | string | 共有リンク。 |