Schemas
AnswerHistoryMessage
rolecontentMessage content
AnswerSourceItem
urlURL to fetch content from
contentPre-supplied document content (used as fallback if fetch fails). In sources_mode=context, only the first 5000 characters are injected into the prompt.
titleDocument title
AnswerRequest
queryUser question
filterCanonical domain filter for search (without www or URL scheme) — if omitted, no site: constraint is applied
streamStream the response as SSE
Conversation history — strictly alternating user/assistant pairs (user first), max 10 pairs (20 messages)
modeResponse length mode
languageAnswer language
markdownWhether the response should use Markdown formatting
related_queriesWhether to generate up to 5 related search queries (search-engine style)
query_rewriteRewrite search query before web search
Caller-supplied sources — bypasses Bloom search when provided. query_rewrite is ignored when this field is set.
sources_mode'search' fetches+reranks sources like web results (default); 'context' injects full content directly without reranking
AnswerStepUsage
stepinput_tokensoutput_tokensAnswerResult
request_idRequest / trace identifier.
answerrelated_queriesSearchWebResponseQuery
qmarketcountoffsetaltered_querySearchWebChunkScore
chunkReranked text chunk.
scoreRelevance score between 0 and 1.
SearchWebResult
titleurlsnippetOriginal snippet from the search provider.
display_urlhostnamefavicon_urlthumbnailPresent only when extra_snippets=true.
Present only when full_content is set.
published_datePublication date (ISO 8601).
SearchWebResults
SearchWebConfidenceDispatcher
decisionversionthreshold_validationSearchWebConfidence
scoreSearchWebResponse
search_idRequest / trace identifier.
SearchWebRequestBody
qmarketDefaults to fr-FR.
countDefaults to 10.
offsetDefaults to 0.
extra_snippetsDefaults to false.
full_contentIf provided, fetches pages for each SERP result and returns the full page content on each link. markdown returns the extracted body as Markdown; html returns the raw page HTML. When combined with extra_snippets, results follow the reranked order.
max_snippetsMaximum number of scored chunks retained per URL in the output. Defaults to 3.
min_scoreMinimum reranker score (0–1) for a chunk to be retained. Defaults to 0.10.
include_domainsRestrict results to these domains. POST only. Up to 10 entries (extras are dropped). Mutually exclusive with exclude_domains. Equivalent to site: operators in q.
exclude_domainsExclude these domains from results. POST only. Up to 10 entries (extras are dropped). Equivalent to -site: operators in q.