websearch

Run a live websearch.

Run a live websearch on a set of queries, get back a fully structured and LLM-distilled response (in addition to the raw text if you need that as well).

Your response includes as_string and as_dicts, where as_string is a prompt-optimized distillation of the information, done by an LLM. as_dicts contains all the details necessary to feed into other parts of your application.

get/v1/chat/websearch

Request

Query parameters

queriesstring[] required

A list of queries to be live searched, analyzed, distilled, and structured.

lookbackinteger nullable

Number of hours back to allow the websearch to look. Defaults to All time

start_datetimestring date-time nullable

Earliest acceptable publication datetime for results. For v1, acts like the existing lookback filter.

end_datetimestring date-time nullable

Latest acceptable publication datetime for results.

engine'v1' | 'v1.5'

Search engine version to use for live websearch results.

domainsstring[] nullable

A list of domains to search.

strictboolean

If true, the websearch will only return results that have a known publication date and are within the lookback period.

integer
OR
string

Response

Structured websearch.

as_stringstring required

Changes

No recorded changes to this operation across all 11 revisions of this API.