ChatGPT

Capture the answer ChatGPT gives for a query and receive it in the same canonical Envelope every surface returns.

Captures come from the real ChatGPT app in a live browser, not a sanitized model API. You get what a person would actually see.

Field	Value
Surface enum	`chatgpt`
Credits per capture	5 (charged only on success)
Alias endpoint	`POST /v1/search/chatgpt`

Capture ChatGPT

With `POST /v1/search`

Pass surfaces: ["chatgpt"]. A single-surface request with no webhook runs synchronously by default — a 200 with the finished Envelope inline. Add ?mode=async for the durable 202 + poll path:

curl -X POST "https://api.aisearchapi.dev/v1/search?mode=async" \
  -H "Authorization: Bearer $AISEARCH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "best noise-cancelling headphones under $300",
    "surfaces": ["chatgpt"],
    "regions": [{ "country": "US" }]
  }'

{
  "jobId": "job_8t2q",
  "status": "processing",
  "children": ["job_8t2q.chatgpt.us"]
}

Fetch the child Envelope once it’s done with GET /v1/jobs/job_8t2q.chatgpt.us. See Synchronous and Asynchronous.

With the alias `POST /v1/search/chatgpt`

The per-surface alias targets ChatGPT only — sync by default like any single-surface call — and accepts prompt (an alias of query) and a flat country.

curl -X POST https://api.aisearchapi.dev/v1/search/chatgpt \
  -H "Authorization: Bearer $AISEARCH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "best noise-cancelling headphones under $300",
    "country": "US"
  }'

const res = await fetch('https://api.aisearchapi.dev/v1/search/chatgpt', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.AISEARCH_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    prompt: 'best noise-cancelling headphones under $300',
    country: 'US',
  }),
});

const result = await res.json();
const envelope = result.children[0];

Request fields

query

string

required

The prompt to run — a non-empty string. On the alias endpoint you may send prompt instead.

surfaces

string[]

required

For this page, ["chatgpt"]. Only used with POST /v1/search — the alias infers the surface from the path.

regions

object[]

{ country, state?, city?, language? }[], country as an ISO-3166 alpha-2 code, at most 10 per request. Omitted: one untargeted (GLOBAL) capture. See Regions.

The Envelope

ChatGPT returns the same canonical Envelope as every other surface, so one parser handles them all. Below it’s trimmed; the real result always has four sections (job, provenance, answer, evidence). For the full schema, see Output formats.

Envelope (trimmed)

{
  "job": {
    "id": "job_8t2q.chatgpt.us",
    "query": "best noise-cancelling headphones under $300",
    "surface": "chatgpt",
    "region": "us",
    "status": "completed",
    "warnings": [],
    "requestedAt": "2026-06-27T00:00:00.000Z",
    "completedAt": "2026-06-27T00:00:03.120Z"
  },
  "provenance": {
    "model": {
      "providerId": null,
      "observedLabel": "gpt-5-3",
      "inferred": true,
      "confidence": 0.6
    },
    "webSearch": { "enabled": true, "known": true },
    "triggerState": "search",
    "persona": "anonymous_default_model",
    "loginState": "logged_out",
    "surfacePresent": true,
    "region": { "requested": "US", "effective": "US" },
    "capturedAt": "2026-06-27T00:00:03.000Z",
    "callUuid": "call_e9e13810ec46f8bbb814497766d1d05c",
    "schemaVersion": "2026-06-27"
  },
  "answer": {
    "text": "For under $300, the Sony WH-1000XM5 and Bose QuietComfort Ultra lead on noise cancellation...",
    "markdown": "For under $300, the **Sony WH-1000XM5** and **Bose QuietComfort Ultra** lead on noise cancellation...",
    "blocks": [
      {
        "type": "paragraph",
        "text": "The Sony WH-1000XM5 offers class-leading ANC.",
        "referenceIds": [0]
      }
    ]
  },
  "evidence": {
    "sources": [
      {
        "id": 0,
        "url": "https://www.sony.com",
        "title": "Sony WH-1000XM5",
        "role": "cited",
        "cited": true,
        "charRanges": [[10, 25]]
      },
      {
        "id": 1,
        "url": "https://www.bose.com",
        "title": "Bose QuietComfort Ultra",
        "role": "cited",
        "cited": true,
        "charRanges": [[30, 52]]
      }
    ],
    "fanOut": {
      "provenance": "observed",
      "queries": ["best noise cancelling headphones under 300 2026"]
    },
    "mentions": null,
    "shopping": null,
    "ads": null
  }
}

answer.text

string

Plain-text answer.

answer.markdown

string

Markdown rendering of the answer. Always populated.

answer.blocks

object[]

Structured blocks, each typed (paragraph, heading, list, code, quote) with text and referenceIds.

evidence.sources

object[]

Cited and retrieved sources, each { id, url, title, role, cited, charRanges }. id is an integer that answer.blocks[].referenceIds point to.

evidence.fanOut

object

The follow-up web searches behind the answer. ChatGPT surfaces these, so provenance is "observed" and queries is populated. mentions, shopping, and ads are reserved and currently null.

provenance.model

object

Which model produced the answer: { providerId, observedLabel, inferred, confidence }.

provenance.surfacePresent

boolean

true when ChatGPT returned an answer; false when it returned nothing.

If ChatGPT returns nothing for a query, provenance.surfacePresent is false and a surface_absent warning is attached. The job still completes with an empty answer — absence is a valid result, and it costs no credits.

Because the Envelope is identical across surfaces, code written for ChatGPT works unchanged for Claude, Perplexity, Copilot, and the rest. See Output formats.

Search reference

Full request and response schema for POST /v1/search.

Output formats

The canonical Envelope every surface returns.

Endpoints

Account & discovery

Watches

By surface

Capture ChatGPT

With `POST /v1/search`

With the alias `POST /v1/search/chatgpt`

Request fields

The Envelope

Search reference

Output formats

​Capture ChatGPT

​With POST /v1/search

​With the alias POST /v1/search/chatgpt

​Request fields

​The Envelope

Search reference

Output formats

Capture ChatGPT

With `POST /v1/search`

With the alias `POST /v1/search/chatgpt`

Request fields

The Envelope