# ChatGPT Search by Prompt

Bright Data

Collect an observed ChatGPT answer, citations and search sources.

## Use this tool with your AI agent

1. Copy the prompt
2. Paste it into your agent
3. Tell it what you need

Read https://scrollport.com/start. Use my existing Scrollport connection, or help me connect if needed. Help me use ChatGPT Search by Prompt (tool ID: brightdata.chatgpt-search). Ask me for the details you need, then show me the result.

**Already connected:** Your agent can use that connection.

**New user:** Your agent will guide you through setup, sign-in and authorisation.

Provider access is included.

Connect your first agent to receive $1 trial credit.

**Job:** [Track AI search visibility](https://scrollport.com/tools/ai-visibility-tracker)

**Current price:** $0.0025/request

**Availability:** Ready to run

## Tool details

**About this tool**

Run one prompt against ChatGPT from a requested country. Returns answer markdown, model, prompt time, citations and search sources as observed by Bright Data. web_search permits the model to search; web_search_triggered reports whether it did. An answer without citations remains a valid observation, not evidence of zero brand visibility. Slow requests resume their existing collection snapshot within a four-minute window. Compare with other samples and inspect cited pages before drawing conclusions; this does not measure every user's personalized answer or prove why a brand appears.

**Inputs and outputs**

### Input

`country` string · optional

Two-letter country code, for example US or GB; normalized to uppercase for collection.

`prompt` string · required

Instruction describing the requested generated output.

minLength: 1 · maxLength: 4096

`web_search` boolean · optional

Allow web search; this does not guarantee it happens.

### Output

`answer_text_markdown` string

Returned answer text markdown value.

`citations` array

Returned citations value.

`country` string

Returned country value.

`engine` string

Returned engine value.

`model` null

Returned model value.

`prompt` string

Instruction describing the requested generated output.

`prompt_sent_at` string

Returned prompt sent at value.

`requested_country` string

Returned requested country value.

`retrieved_at` string

Returned retrieved at value.

`search_sources` array

Returned search sources value.

`web_search` boolean

Returned web search value.

`web_search_triggered` boolean

Returned web search triggered value.

**Example request and output**

Inspect returns this reviewed example, its estimated cost and the current input schema. Run calculates the estimate for your actual input.

### Request

```
{
  "tool_id": "brightdata.chatgpt-search",
  "input": {
    "prompt": "What is IANA's example.com domain used for? Cite the official source.",
    "country": "US",
    "web_search": true
  }
}
```

### Output

```
{
  "model": null,
  "engine": "chatgpt",
  "prompt": "What is IANA's example.com domain used for? Cite the official source.",
  "country": "US",
  "citations": [
    {
      "url": "https://www.iana.org/help/example-domains?utm_source=chatgpt.com",
      "icon": null,
      "cited": true,
      "title": "Example Domains",
      "domain": "https://www.iana.org",
      "position": 1,
      "description": "IANA",
      "answer_position": null
    }
  ],
  "web_search": true,
  "retrieved_at": "2026-09-07T11:01:38.153Z",
  "prompt_sent_at": "2026-09-07T10:57:53.311Z",
  "search_sources": [
    {
      "url": "https://www.iana.org/help/example-domains?utm_source=chatgpt.com",
      "rank": 1,
      "title": "Example Domains",
      "snippet": null,
      "date_published": "2017-05-13T00:00:00.000Z"
    },
    {
      "url": "https://www.iana.org/news/2024/example-domain-http-methods?utm_source=chatgpt.com",
      "rank": 2,
      "title": "Changes to HTTP service for example domains",
      "snippet": null,
      "date_published": null
    },
    {
      "url": "https://www.iana.org/assignments/special-use-domain-names?utm_source=chatgpt.com",
      "rank": 3,
      "title": "Special-Use Domain Names",
      "snippet": null,
      "date_published": "2012-07-06T00:00:00.000Z"
    }
  ],
  "requested_country": "US",
  "answer_text_markdown": "*   IANA’s **example.com** is a **reserved domain intended for documentation and illustrative examples**.\n    \n    According to IANA:\n    \n    *   `example.com`, along with `example.org` and `example.net`, is maintained specifically for **documentation purposes**.\n    *   You can use it in tutorials, technical documentation, sample configurations, code examples, etc., without needing to coordinate with IANA or worry that someone else will register it.\n    *   It is **not available for registration or transfer**.\n    *   IANA provides a simple website on the domain to explain its purpose, but explicitly says that this service is **not intended for production applications or as a testing endpoint**. IANA+1\n    *   IANA also lists `example.com` in its **Special-Use Domain Names** registry under RFC 6761. IANA\n    \n    **Official IANA source:** IANA — Example Domainsiana.org citeturn0search0\n    \n    Sources",
  "web_search_triggered": true
}
```

**Errors and limitations**

- `upstream_error`: The ChatGPT answer could not be collected.The wallet was not charged. A missing citation alone is not a collection failure.

---

Canonical page: https://scrollport.com/tools/providers/brightdata/chatgpt-search