ChatGPT Scraper
scraper.chatgpt アクターを使用すると、UI をリバースエンジニアリングすることなく、ChatGPT の回答(Markdown 形式の応答、検索リンク、および帰属データを含む)をキャプチャできます。
リクエスト例
curl 'https://api.scrapeless.com/api/v2/scraper/request' \
--header 'Content-Type: application/json' \
--header 'x-api-token: {you_api_key}' \
--data '{
"actor": "scraper.chatgpt",
"input": {
"prompt": "Most reliable proxy service for data extraction",
"country": "JP",
"web_search": true,
"shopping": true
},
"webhook": {
"url": "http://www.youwebhook.com"
}
}'リクエストボディパラメータ
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
prompt | string | はい | ChatGPT に送信するプロンプト。 |
country | string | はい | 国または地域コード。 |
web_search | boolean | いいえ | ウェブ検索を有効にするかどうか。 |
shopping | boolean | いいえ | ショッピングデータを取得するかどうか。デフォルトは true です。有効にすると、products フィールドに商品情報が返されます。 |
レスポンスフィールド
注: レスポンスにショッピングデータ(
productsフィールド)が含まれる場合、API 呼び出しは基本料金の 2 倍で課金されます。これは、複数のソースから商品情報を抽出および処理するために追加のリソースオーバーヘッドが必要となるためです。
| パラメータ | 型 | 説明 |
|---|---|---|
prompt | string | 元のプロンプト。 |
result_text | string | ChatGPT からの Markdown 形式の応答。 |
model | string | モデル識別子(例: gpt-5-1)。 |
web_search | bool | 検索拡張が実行されたかどうかを示します。 |
links | array | 補足リンクの配列。 |
search_result | array | レスポンスに関連付けられた SERP 結果。 |
search_result.attribution | string | 検索結果のソース。 |
search_result.snippet | string | ChatGPT が提供するスニペット。 |
search_result.title | string | 検索ヒットのタイトル。 |
search_result.url | string | 検索ヒットの URL。 |
content_references | array | ChatGPT の回答内に含まれる参照。 |
content_references.attribution | string | 参照のソース。 |
content_references.title | string | 参照コンテンツのタイトル。 |
content_references.url | string | 参照コンテンツの URL。 |
products | array | ChatGPT が返す商品情報。 |
products.id | string | 一意の商品識別子。 |
products.title | string | 商品タイトル。 |
products.description | string | 商品の説明(null の場合があります)。 |
products.price | string | 表示価格(例: $799.99)。 |
products.rating | float | 平均評価スコア。 |
products.num_reviews | int | レビュー数。 |
products.merchants | string | 販売店名(例: Sony + others)。 |
products.image_urls | array | 商品画像 URL の配列。 |
products.url | string | 商品ページの URL。 |
products.offers | array | 購入オファーの配列。 |
products.offers.merchant_name | string | 販売店名。 |
products.offers.price | string | オファー価格。 |
products.offers.price_details | object | 価格の内訳詳細。 |
products.offers.price_details.base | string | 基本価格。 |
products.offers.price_details.total | string | 税金と送料を含む合計価格。 |
products.offers.available | bool | 商品の在庫状況。 |
products.offers.details | string | 配送および在庫情報。 |
products.offers.url | string | チェックアウトまたは商品ページの URL。 |
products.rating_grouped_citation | object | 評価の引用データ。 |
products.rating_grouped_citation.title | string | 引用タイトル。 |
products.rating_grouped_citation.url | string | 引用 URL。 |
products.rating_grouped_citation.supporting_websites | array | 評価を裏付けるウェブサイト。 |
products.rating_grouped_citation.supporting_websites.title | string | ウェブサイトのタイトル。 |
products.rating_grouped_citation.supporting_websites.url | string | ウェブサイトの URL。 |
ads | object | ChatGPT が返す広告情報。 |
ads.type | string | 広告レスポンスのタイプ(例: ads)。 |
ads.content | object | 広告のコンテンツ。 |
ads.content.type | string | 広告ユニットのタイプ(例: single_advertiser_ad_unit)。 |
ads.content.advertiser_brand | object | 広告主ブランド情報。 |
ads.content.advertiser_brand.id | string | 広告主ブランドの一意の識別子。 |
ads.content.advertiser_brand.name | string | 広告主ブランド名。 |
ads.content.advertiser_brand.url | string | 広告主ブランドのウェブサイト URL。 |
ads.content.advertiser_brand.favicon_url | string | 広告主のファビコンアイコンの URL。 |
ads.content.ad_cards | array | 広告カードの配列。 |
ads.content.ad_cards.title | string | 広告カードのタイトル。 |
ads.content.ad_cards.body | string | 広告の本文テキストまたは説明。 |
ads.content.ad_cards.company_name | string | 広告主企業名。 |
ads.content.ad_cards.format | string | 広告カードのフォーマット(例: image_card_v2)。 |
ads.content.ad_cards.image_url | string | 広告画像の URL。 |
ads.content.ad_cards.cta_product_copy | string | CTA(行動喚起)商品コピー(null の場合があります)。 |
ads.content.ad_cards.card_header | object | 広告カードのヘッダー情報。 |
ads.content.ad_cards.card_header.title | string | カードヘッダーのタイトル。 |
ads.content.ad_cards.card_header.subtitle | string | カードヘッダーのサブタイトル(例: Sponsored)。 |
ads.content.ad_cards.card_header.logo_url | string | 広告主のロゴ URL。 |
ads.content.ad_cards.favicon_url | string | 広告のファビコン URL。 |
ads.content.ad_cards.target | object | 広告のターゲットリンク情報。 |
ads.content.ad_cards.target.type | string | ターゲットのタイプ(例: url)。 |
ads.content.ad_cards.target.value | string | ターゲットリンクの実際の URL 値。 |
ads.content.ad_cards.target.open_externally | bool | リンクを外部で開くかどうか。 |
ads.content.carousel_cards | array | カルーセル広告カードの配列。 |
ads.content.carousel_cards.title | string | カルーセルカードのタイトル。 |
ads.content.carousel_cards.body | string | カルーセルカードの本文テキストまたは説明。 |
ads.content.carousel_cards.image_url | string | カルーセルカード画像の URL。 |
ads.content.carousel_cards.target | object | カルーセルカードのターゲットリンク情報。 |
ads.content.carousel_cards.target.type | string | ターゲットのタイプ(例: url)。 |
ads.content.carousel_cards.target.value | string | カルーセルターゲットの実際の URL 値。 |
ads.content.carousel_cards.target.open_externally | bool | カルーセルリンクを外部で開くかどうか。 |
map | object | ChatGPT が返すマップおよび地域ビジネスデータ。 |
map.entities | array | 解決されたエンティティのランキングリスト(例: 地域ビジネス)。 |
map.entities.category | string | エンティティカテゴリ(例: local_business)。 |
map.entities.id | string | エンティティ識別子(例: Google Place ID)。 |
map.entities.name | string | エンティティ名。 |
map.entities.latitude | float | エンティティの緯度。 |
map.entities.longitude | float | エンティティの経度。 |
map.entities.extra_params | object | エンティティの追加検索パラメータ。 |
map.entities.extra_params.address | string | エンティティの住所。 |
map.entities.extra_params.business_id | string | ビジネス識別子。 |
map.entities.extra_params.location | string | 検索位置のコンテキスト。 |
map.entities.extra_params.provider | string | データプロバイダー(例: yelp-feed, b3)。 |
map.entities.entity | object | エンティティの詳細レコード。 |
map.entities.entity.address | string | 完全な住所。 |
map.entities.entity.attributes | object | 追加属性(null の場合があります)。 |
map.entities.entity.categories | array | エンティティのカテゴリラベル。 |
map.entities.entity.city | string | 市区町村(null の場合があります)。 |
map.entities.entity.country_code | string | ISO 国コード(例: US)。 |
map.entities.entity.country_name | string | 国名。 |
map.entities.entity.date_closed | string | 閉店日(null の場合があります)。 |
map.entities.entity.date_opened | string | 開店日(null の場合があります)。 |
map.entities.entity.description | string | ビジネスの説明(null の場合があります)。 |
map.entities.entity.description_cite | string | 説明の引用元(null の場合があります)。 |
map.entities.entity.distance_meters | float | 検索位置からの距離(メートル単位)(null の場合があります)。 |
map.entities.entity.enriched_description | string | 拡張された説明(null の場合があります)。 |
map.entities.entity.from_cache | bool | レコードがキャッシュから提供されたかどうか。 |
map.entities.entity.hours | array | 曜日ごとの営業時間。 |
map.entities.entity.hours.day | int | 曜日(0=日曜日 … 6=土曜日)。 |
map.entities.entity.hours.start | string | 24時間制 HHMM 形式の営業開始時間(例: 0800)。 |
map.entities.entity.hours.end | string | 24時間制 HHMM 形式の営業終了時間(例: 1900)。 |
map.entities.entity.id | string | エンティティ識別子。 |
map.entities.entity.image_url | string | 主要画像の URL。 |
map.entities.entity.image_urls | array | 画像 URL の配列。 |
map.entities.entity.is_claimed | bool | ビジネスリストが所有権確認済みかどうか(null の場合があります)。 |
map.entities.entity.is_closed_permanently | bool | 永久閉店しているかどうか。 |
map.entities.entity.is_closed_temporarily | bool | 一時閉店しているかどうか。 |
map.entities.entity.is_open | bool | 現在営業中かどうか。 |
map.entities.entity.latitude | float | 緯度。 |
map.entities.entity.location | string | 位置のコンテキスト(例: Portland, OR, USA)。 |
map.entities.entity.longitude | float | 経度。 |
map.entities.entity.menu | object | メニュー情報(null の場合があります)。 |
map.entities.entity.menu.url | string | メニューの URL。 |
map.entities.entity.name | string | ビジネス名。 |
map.entities.entity.next_open_hour | object | 次の営業時間枠。 |
map.entities.entity.next_open_hour.day | int | 次の営業日の曜日。 |
map.entities.entity.next_open_hour.start | string | 次の営業開始時間(HHMM)。 |
map.entities.entity.next_open_hour.end | string | 対応する営業終了時間(HHMM)。 |
map.entities.entity.phone | string | 電話番号。 |
map.entities.entity.popularity_score | float | 人気度スコア(null の場合があります)。 |
map.entities.entity.price | string | 価格値(null の場合があります)。 |
map.entities.entity.price_str | string | 価格帯の指標(例: $, $$)(null の場合があります)。 |
map.entities.entity.provider | string | ソースプロバイダー(例: yelp-feed, b3, bright-feed)。 |
map.entities.entity.provider_images | array | プロバイダー提供の画像(null の場合があります)。 |
map.entities.entity.provider_logo_dark_url | string | ダークモード用のプロバイダーロゴ URL(null の場合があります)。 |
map.entities.entity.provider_logo_url | string | プロバイダーロゴ URL(null の場合があります)。 |
map.entities.entity.provider_url | string | プロバイダーサイト上のエンティティ URL。 |
map.entities.entity.rank | int | ランク位置(null の場合があります)。 |
map.entities.entity.ranking_score | float | 内部ランキングスコア。 |
map.entities.entity.rating | float | 平均評価。 |
map.entities.entity.rating_scale | int | 最大評価スケール(例: 5)。 |
map.entities.entity.reconciled_thumbnails | array | プロバイダー間で統合されたサムネイル。 |
map.entities.entity.reconciled_thumbnails.image_url | string | サムネイル画像の URL。 |
map.entities.entity.reconciled_thumbnails.obfuscated_provider | string | サムネイルの難読化されたプロバイダー名。 |
map.entities.entity.reservation_providers | array | 利用可能な予約プロバイダー。 |
map.entities.entity.review_count | int | レビュー数。 |
map.entities.entity.review_highlights | array | 強調表示されたレビュー抜粋(null の場合があります)。 |
map.entities.entity.reviews | array | レビューレコード(null の場合があります)。 |
map.entities.entity.service_providers | array | サービスプロバイダー(null の場合があります)。 |
map.entities.entity.special_hours | array | 特別営業日/祝日の営業時間(null の場合があります)。 |
map.entities.entity.state | string | 州または地域コード(null の場合があります)。 |
map.entities.entity.tags | array | 属性タグ(例: アクセシビリティ機能)。 |
map.entities.entity.website_url | string | 公式ウェブサイト URL。 |
map.entities.entity.yelp_menu_url | string | Yelp メニュー URL(null の場合があります)。 |
map.entities.entity.zipcode | string | 郵便番号(null の場合があります)。 |
map.raw_search_entities | array | 未加工の未ランク付け検索エンティティ。各項目は map.entities と同じ構造を共有します。 |
search_model_queries | array | ファンアウトクエリの配列。 |