ChatGPT スクレイパー
UIを逆エンジニアリングすることなく、Markdown形式の応答、検索リンク、帰属データを含むChatGPTの回答を取得するために scraper.chatgpt actorを使用します。
リクエストの例
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 | いいえ | Web検索を有効にするかどうか。 |
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 | 行動喚起の製品コピーテキスト(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 | ZIPコード/郵便番号(nullの場合あり)。 |
map.raw_search_entities | array | 生の、順位付けされていない検索エンティティ。各アイテムは map.entitiesと同じ構造を持つ。 |
search_model_queries | object | ファンアウトクエリ。 |
search_model_queries.queries | array | ファンアウトクエリの配列。 |