Skip to main content
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

​
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_TOKEN
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.
Dataset ID: gd_m7aof0k82r803d5bjm 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_TOKEN" \
  -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. 
[
  {
    "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_TOKEN" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://chatgpt.com/", "prompt": "Best local restaurants", "country": "JP"}]'

[
  {
    "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_TOKEN" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://chatgpt.com/", "prompt": "Top hotels in New York", "additional_prompt": "Which of these are pet-friendly?"}]'

[
  {
    "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

EndpointDataset IDInput
ChatGPT Searchgd_m7aof0k82r803d5bjmurl + prompt

​
Input fields

FieldRequiredDescription
urlYesAlways https://chatgpt.com/
promptYesSearch prompt (max 4,096 characters)
countryNoCountry code for location-targeted results
indexNoUnique tracking ID (number)
require_sourcesNoReturn error if no sources found (boolean)
additional_promptNoFollow-up prompt within the same session
web_searchNoEnable or disable web search (default: true)

​
Output formats

Control the response format with the format query parameter:
ValueDescription
jsonJSON array (default)
ndjsonNewline-delimited JSON, one record per line
csvComma-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.