ChatGPT Scraper API endpoints

This guide shows you how to send synchronous requests to the Bright Data ChatGPT Scraper API. It covers basic search, country-targeted search, and follow-up prompts.

Prerequisites

A Bright Data account with an active API key
Completed the Quickstart

Request structure

Every synchronous request follows the same pattern:

POST https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_m7aof0k82r803d5bjm&format=json
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

[{"url": "https://chatgpt.com/", "prompt": "Your search prompt here"}]

The url field is always https://chatgpt.com/. The prompt field contains your search query.

The /scrape endpoint is built for real-time, single-URL requests. Bright Data recommends 20 inputs or fewer per request, a best practice rather than a hard limit, and the endpoint waits up to 1 minute. If collection takes longer, the response is HTTP 202 with a snapshot_id instead of data, and collection continues asynchronously. Fetch the result with async requests or have it pushed to you with webhook delivery.

How to scrape ChatGPT Search

Dataset ID: gd_m7aof0k82r803d5bjm

How to send a basic search

Send a prompt and get a structured answer with citations:

curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_m7aof0k82r803d5bjm&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://chatgpt.com/", "prompt": "Top hotels in New York"}]'

You should see a 200 response. Processing time varies with target-site conditions and scraper workload.

Example response

[
  {
    "url": "https://chatgpt.com/?q=Top%20hotels%20in%20New%20York",
    "prompt": "Top hotels in New York",
    "answer_text": "Map data is currently unavailable Aman New York 4.3 Отель 2 450 $ The Plaza Hotel The Carlyle, A Rosewood Hotel 4.5 Отель 1 359 $ The Mark Hotel 4.5 Отель 2...",
    "answer_text_markdown": "*   Map data is currently unavailable![](https://images.openai.com/static-rsc-1/3CY66dbP3KXwQ7yDckANu6xIJ-NtQwAsXzoo2jAaWY6HKEHzvQ6cRzvjKFZEX9NpW5wWXY-HzQqfO...",
    "model": null,
    "web_search_triggered": true,
    "is_map": true,
    "shopping_visible": false,
    "citations": [
      {
        "url": "https://www.timeout.com/newyork/hotels/best-luxury-hotels-in-nyc?utm_source=chatgpt.com",
        "title": "16 Best Luxury Hotels in New York City For 2026 | World-Class Hotels in NYC",
        "description": "Time Out Worldwide",
        "icon": null
      }
    ],
    "search_sources": [
      {
        "url": "https://www.timeout.com/newyork/hotels/best-luxury-hotels-in-nyc?utm_source=chatgpt.com",
        "title": "16 Best Luxury Hotels in New York City For 2026 | World-Class Hotels in NYC",
        "snippet": null,
        "rank": 1
      }
    ]
  }
]

Search with country targeting

Use the country field to get location-specific results:

curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_m7aof0k82r803d5bjm&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://chatgpt.com/", "prompt": "Best local restaurants", "country": "JP"}]'

Example response

[
  {
    "url": "https://chatgpt.com/?q=Best%20local%20restaurants",
    "prompt": "Best local restaurants",
    "answer_text": "Map data is currently unavailable すしレストラン FUJIYAMA TOKYO 新宿東口店 4.7 寿司店 indian restaurant khana (HALAL) 4.4 インド料理店 ￥1,000～2,000 神戸鉄板焼 白秋 4.7 ステーキハウス ￥10,000 以...",
    "model": null,
    "web_search_triggered": false,
    "is_map": true,
    "citations": [],
    "prompt_sent_at": "2026-09-06T10:23:10.445Z",
    "answer_html": "<html lang=\"en-US\" dir=\"ltr\" data-theme=\"light\" data-contrast=\"default\" data-build=\"prod-4ec31e730ff961987ab0f9a7e9dd6248f66da3b0\" data-close-image-viewer=\"C...",
    "country": "JP"
  }
]

Search with follow-up prompt

Use the additional_prompt field to ask a follow-up question in the same session:

curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_m7aof0k82r803d5bjm&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://chatgpt.com/", "prompt": "Top hotels in New York", "additional_prompt": "Which of these are pet-friendly?"}]'

Example response

[
  {
    "url": "https://chatgpt.com/?q=Top%20hotels%20in%20New%20York",
    "prompt": "Top hotels in New York",
    "answer_text": "Map data is currently unavailable The St. Regis New York 4.5 Hotel $2,201 Park Hyatt New York 4.6 Hotel $3,191 The Carlyle, A Rosewood Hotel 4.5 Hotel $1,359...",
    "additional_answer_text": "Map data is currently unavailable Park Hyatt New York 4.6 Hotel The Manner 4.6 Resort hotel Refinery Hotel 4.5 Hotel Made Hotel 4.4 Hotel New York Hilton Mid...",
    "model": null,
    "web_search_triggered": true,
    "citations": [
      {
        "url": "https://www.cntraveler.com/gallery/best-hotels-in-new-york-city?utm_source=chatgpt.com",
        "title": "35 Best Hotels in New York City We Won't Shut Up About | Condé Nast Traveler",
        "description": "Condé Nast Traveler",
        "icon": null
      }
    ],
    "prompt_sent_at": "2026-09-06T10:23:07.451Z",
    "answer_html": "<html lang=\"en-US\" dir=\"ltr\" data-theme=\"light\" data-contrast=\"default\" data-build=\"prod-4ec31e730ff961987ab0f9a7e9dd6248f66da3b0\" data-close-image-viewer=\"C...",
    "is_map": true
  }
]

Full ChatGPT Search response schema

Which output fields does the ChatGPT Search scraper return?

The ChatGPT Search scraper (gd_m7aof0k82r803d5bjm, collect_by_url) returns 32 output fields.

Output fields (32)

Field	Type	Description
`url`	url	ChatGPT page URL
`prompt`	text	The input prompt
`answer_html`	text	The answer of ChatGPT search
`answer_text`	text	Answer text in plain text
`links_attached`	array	Hyperlinks included in the response text, along with their position and linked words.
`citations`	array	Sources directly referenced in the answer, often linked to specific facts or claims.
`country`	country	Country from which to perform the search
`is_map`	boolean	Indication whether a map package result was generated
`references`	array	Links grouped under the References section
`shopping`	array	Product recommendation cards from ChatGPT’s Shopping panel
`shopping_visible`	boolean	Whether the Shopping panel appeared for this answer
`index`	number	The index column lets you assign a unique ID to each crawl request for easy tracking.
`answer_text_markdown`	html2markdown	Answer text in markdown format.
`web_search_triggered`	boolean	Was a web search triggered by ChatGPT when returning the answer
`additional_prompt`	text	The additional_prompt is a follow-up input sent after receiving the first answer, aiming to clarify, expand, or refine the initial response. The system processes this prompt and returns the result as additional_answer_text.
`additional_answer_text`	text	The additional_answer_text is the system’s response to the additional_prompt, which follows the initial interaction. It provides additional information, clarification, or a refined answer based on the user’s follow-up input.
`map`	array	Map package result
`search_sources`	array	A list of external web pages ChatGPT used to gather information, usually shown at the bottom of the response.
`search_sources_more`	array	A list of external web pages ChatGPT used to gather information, usually shown at the bottom of the response (from “More” partition).
`response_raw`	text	Raw data of ChatGPT’s response
`response_raw_additional_prompt`	text	Raw data of ChatGPT’s response for additional prompt.
`answer_section_html`	text	The answer’s section html
`model`	text	Model used for answer
`web_search_query`	array	Model-generated web search queries (exact strings, in execution order)
`prompt_sent_at`	date	exact prompt timestamp
`answer_text_raw`	text	Original answer_text as extracted, without trimming or whitespace normalization (may include leading/trailing spaces and newline characters).
`business_locations`	array	Please consider adding new fields, attaching example of JSON we can get for each business location mentioned in answer. Array of business location entities returned when the answer includes local business results. Each entry contains the business ID, coordinates, name, category, address, contact info, ratings, hours, images, and open/closed status.
`ads`	array	Array of advertisement’s card data.
`additional_answer_text_markdown`	html2markdown	additional_answer_text_markdown in markdown format.
`questionnaire`	array	Questionnaire
`shopping_additional_prompt`	array	Product recommendation cards from ChatGPT’s Shopping panel from results of additional prompt
`citations_additional_prompt`	array	Sources directly referenced in the answer of additional prompt, often linked to specific facts or claims.

Machine-readable version with the input schema: /scrapers/gd_m7aof0k82r803d5bjm.json

Quick reference: dataset ID

Endpoint	Dataset ID	Input
ChatGPT Search	`gd_m7aof0k82r803d5bjm`	`url` + `prompt`

Input fields

Field	Required	Description
`url`	Yes	Always `https://chatgpt.com/`
`prompt`	Yes	Search prompt (max 4,096 characters)
`country`	No	Country code for location-targeted results
`index`	No	Unique tracking ID (number)
`require_sources`	No	Return error if no sources found (boolean)
`additional_prompt`	No	Follow-up prompt within the same session
`web_search`	No	Allow (`true`, the default) or disable (`false`) web search during the run. Read `web_search_triggered` in the response to know whether a search ran; see Query fan-out and web search control

Output formats

Control the response format with the format query parameter:

Value	Description
`json`	JSON array
`ndjson`	Newline-delimited JSON, one record per line (default)
`csv`	Comma-separated values

These are the format values for /scrape. The full list, NDJSON (default), JSON, JSON lines, CSV and Parquet, and where each applies is in output formats.

Async batch requests

Search ChatGPT with hundreds of prompts in a single batch job.

API reference

Full parameter and response field reference.

Get started

Data extraction

Web search

AI training data

Proxy networks

ChatGPT Scraper API endpoints

Prerequisites

Request structure

How to scrape ChatGPT Search

How to send a basic search

Search with country targeting

Search with follow-up prompt

Which output fields does the ChatGPT Search scraper return?

Quick reference: dataset ID

Input fields

Output formats

Async batch requests

API reference

​Prerequisites

​Request structure

​How to scrape ChatGPT Search

​How to send a basic search

​Search with country targeting

​Search with follow-up prompt

​Which output fields does the ChatGPT Search scraper return?

​Quick reference: dataset ID

​Input fields

​Output formats

​Related

Async batch requests

API reference

Prerequisites

Request structure

How to scrape ChatGPT Search

How to send a basic search

Search with country targeting

Search with follow-up prompt

Which output fields does the ChatGPT Search scraper return?

Quick reference: dataset ID

Input fields

Output formats

Related