ChatGPT ↗
Claude ↗This page documents the canonical HTTP contract for this endpoint.
The response uses the research_read.v1 envelope. The contents of data are provider-specific; the empty object is only a placeholder and does not promise provider result fields. Requests reject extra fields. Provider usage and any applicable billing are determined by the current operation configuration; this endpoint does not publish a fixed price.
Body parameters
objectiverequiredstring
Search objective, 1–2,000 characters.
search_queriesrequiredarray<string>
One to three queries.
mode· optionalstring
turbo, basic (default), or advanced.
max_chars_total· optionalinteger|null
Optional result character budget, 1,000–25,000.
include_domains· optionalarray<string>
Domain allowlist; defaults to []. Maximum 100 entries.
exclude_domains· optionalarray<string>
Domain denylist; defaults to []. Maximum 100 entries.
after_date· optionalstring|null
Optional provider date filter.
country· optionalstring|null
Optional two-character country code.
| Name | Type | Description |
|---|---|---|
| objectiverequired | string | Search objective, 1–2,000 characters. |
| search_queriesrequired | array<string> | One to three queries. |
| mode | string | turbo, basic (default), or advanced. |
| max_chars_total | integer|null | Optional result character budget, 1,000–25,000. |
| include_domains | array<string> | Domain allowlist; defaults to []. Maximum 100 entries. |
| exclude_domains | array<string> | Domain denylist; defaults to []. Maximum 100 entries. |
| after_date | string|null | Optional provider date filter. |
| country | string|null | Optional two-character country code. |
Errors
| Status | Meaning |
|---|---|
| 401 | Authentication is required. |
| 403 | The caller lacks access to the resource or the search:run scope. |
| 400 | The request does not satisfy the route or typed request contract. |