Send Your First ChatGPT Search Request

Make synchronous requests to the Bright Data ChatGPT Scraper API with copy-pasteable code examples for search, country targeting, and follow-up prompts.

This tutorial walks you through sending synchronous requests to the Bright Data ChatGPT Scraper API. By the end, you’ll have working examples for 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.

Synchronous requests support up to 20 inputs and have a 1-minute timeout. If the request takes longer, the API automatically returns a snapshot_id instead. See async requests.

ChatGPT Search

Dataset ID: gd_m7aof0k82r803d5bjm

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. This takes 15-45 seconds.

Example response

[
  {
    "url": "https://chatgpt.com/",
    "prompt": "Top hotels in New York",
    "answer_text": "Here are some of the top-rated hotels in New York City...",
    "answer_text_markdown": "Here are some of the top-rated hotels in **New York City**...",
    "model": "gpt-4o",
    "web_search_triggered": true,
    "is_map": false,
    "shopping_visible": false,
    "citations": [
      {
        "title": "Best Hotels in NYC - Travel Guide",
        "url": "https://example.com/nyc-hotels",
        "position": 1
      }
    ],
    "search_sources": [
      {
        "url": "https://example.com/nyc-hotels",
        "title": "Best Hotels in NYC - Travel Guide"
      }
    ],
    "links_attached": [
      {
        "url": "https://example.com/nyc-hotels",
        "text": "Travel Guide"
      }
    ],
    "recommendations": [],
    "references": [],
    "prompt_sent_at": "2026-04-08T12:00:00.000Z"
  }
]

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/",
    "prompt": "Best local restaurants",
    "answer_text": "Here are some highly recommended local restaurants in Japan...",
    "model": "gpt-4o",
    "web_search_triggered": true,
    "is_map": true,
    "citations": [
      {
        "title": "Top Restaurants in Tokyo",
        "url": "https://example.com/tokyo-restaurants",
        "position": 1
      }
    ],
    "prompt_sent_at": "2026-04-08T12:05:00.000Z"
  }
]

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/",
    "prompt": "Top hotels in New York",
    "answer_text": "Here are some of the top-rated hotels in New York City...",
    "additional_answer_text": "Among the hotels listed, the following are pet-friendly...",
    "model": "gpt-4o",
    "web_search_triggered": true,
    "citations": [
      {
        "title": "Pet-Friendly Hotels NYC",
        "url": "https://example.com/pet-friendly-nyc",
        "position": 1
      }
    ],
    "prompt_sent_at": "2026-04-08T12:10:00.000Z"
  }
]

Full ChatGPT Search response schema

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	Enable or disable web search during the run (default: true). This is a permission, not a guarantee: read web_search_triggered in the response to know whether a search actually ran. See Query fan-out and web search control

Output fields (web search signals)

Field	Type	Always returned	Meaning
web_search	boolean	No	Echoes the input value (defaults to true if omitted). Does not indicate whether a search actually happened.
web_search_triggered	boolean	Yes	true only if the model actually triggered a web search during the run; false otherwise.

Do not use prompt-derived output fields like is_map, citations, or shopping_visible as proof that a web search ran. Those fields depend on the prompt and the model’s response format. Use web_search_triggered as the canonical signal. Full rules in Query fan-out and web search control.

Output formats

Control the response format with the format query parameter:

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

Next steps

Async batch requests

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

API reference

Full parameter and response field reference.