v32

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-2114136159.9 KB

Search the Web

Search the web and retrieve relevant web page contents.

post/search

Request body

max_tokensinteger

max_tokens_per_pageinteger

max_resultsinteger

search_domain_filterstring[] nullable

search_language_filterstring[] nullable

search_recency_filter'hour' | 'day' | 'week' | 'month' | 'year' nullable

search_after_date_filterstring nullable

search_before_date_filterstring nullable

last_updated_before_filterstring nullable

last_updated_after_filterstring nullable

search_mode'web' | 'academic' | 'sec' nullable

countrystring nullable

display_server_timeboolean

search_type'web' | 'people' nullable

Search type — "web" for general web search, "people" for people search. max_results above 20 is only supported for people search.

search_context_size'low' | 'medium' | 'high'

Controls how much content is retrieved per result. Larger sizes return more page content at higher cost. Defaults to "high". Omit when supplying explicit max_tokens / max_tokens_per_page.

Response

Successful Response

idstring required

server_timestring nullable