Same contract as GET /api/v1/search, but accepts parameters as a JSON body. Preferred for location-bearing requests because GET-style location encoding is awkward and keeps latitude/longitude out of HTTP access logs. All GET query parameters are accepted as body fields, plus optional location fields (latitude, longitude, accuracy, city, state, countryCode, postalCode, timezone, location).
Search query string. Same semantics as the GET q parameter.
limit
integer
Maximum number of results to return. When omitted, a single-query search returns 10–40 results picked to fit the query (fewer for a site or a fact, more for news, lists, documentation and research); 20 with offset or for multi-query. Set limit for a fixed count.
Required range: 1 <= x <= 100
offset
integer
default:0
Number of results to skip for pagination.
Required range: x >= 0
searchMode
enum<string>
default:auto
Search effort control. auto (default) sets the effort per query automatically — simple lookups resolve fast, complex questions get deeper treatment. The fixed modes pin an effort level: instant puts speed first, returns at most 10 results and no page content, and is never chosen by auto. low-cost caps the work done per request for budget-constrained callers. fast returns results in about 2 seconds. balanced is everyday web search, about 4–5 seconds. deep searches from multiple angles with spell correction, about 6.5 seconds. exhaustive is Andi's most thorough mode: more sources and more time, up to about 15 seconds; for a question with several parts or steps it searches each part. Deeper modes add query expansion, follow-up searches fanned out from initial results, and stronger reranking. Requests are billed on outcome-based pricing (see metrics.cost_dollars).
Available options:
auto,
instant,
low-cost,
fast,
balanced,
deep,
exhaustive
effort
enum<string>
Thoroughness dial, independent of searchMode: low favors speed, medium is balanced, high searches from multiple angles with spell correction, max gives the most complete results and also searches each part of a question that has several parts or steps — the same tiers as pinning searchMode to fast, balanced, deep, and exhaustive respectively. An explicit searchMode always wins over effort. With the default auto mode, an explicit effort pins its equivalent mode. Omit for the adaptive default. Invalid values return a 400 listing the valid tiers.
Available options:
low,
medium,
high,
max
reranker
enum<string>
default:auto
Semantic reranker size hint. small is the lightest and fastest; medium and above apply stronger relevance scoring but need a deeper searchMode and may be clamped by the request's time and cost budget (for example, xl needs deep or exhaustive). auto (default) selects a tier automatically based on the query and search mode.
Available options:
auto,
small,
medium,
large,
xl
intent
string
Force a specific search intent. When not set, the API auto-detects intent from the query. Accepts common aliases like search, news, video, images, weather, wiki, code, recipe, place, time, and others.
format
enum<string>
default:json
Response format. json returns a JSON object. context returns results as markdown text, suitable for passing to language models.
Available options:
json,
context
metadata
enum<string>
default:basic
Level of metadata to include. basic includes standard search metrics. full includes extended metadata with content type details and reader data on results.
Available options:
basic,
full
extracts
boolean
default:false
Include text extracts from result pages in the response. Defaults to true when format=context, content=true or content=focused; pass extracts=false to turn them off in those cases. Also returned by default with metadata=full.
content
booleanenum<string>
default:false
Include each result's full page text, in reader.markdown (or reader.content when the page has no markdown version). true returns the head of each page. "focused" returns the parts of each page that answer the query, in page order under section headings; it is billed and capped like true and falls back to the normal page text when no focused text can be built. Any other value is treated as false. Also turns on extracts unless extracts=false is passed. Adds time and cost; deeper modes allow more time.
enrichContent
boolean
default:false
deprecated
Deprecated alias of content.
maxContentLength
integer
Maximum number of characters of page text to return per result. Only applies when content is true.
preset
enum<string>
Named set of defaults: app (the API's ordinary defaults; used for direct calls) or agent (context format, focused page content, extracts, a 16,000-token budget; used by the MCP server and CLI). A preset fills only parameters you did not send, so any parameter you send wins. The reply states the preset when one was chosen (preset in JSON, a preset line in the context frontmatter).
Available options:
app,
agent
maxTokens
integer
Token budget for the results (1,000 to 200,000). Results with page content fill it first, then results with extracts, then snippets; results that do not fit are dropped from the bottom, keeping rank order, and any result shown in part carries truncated, shown_words and total_words. Default 16,000 with format=context and content=focused (24,000 on deep and exhaustive); on other output it applies only when sent.
Required range: 1000 <= x <= 200000
timeout
integer
Target time in milliseconds for ranked results (1000–30000). It is a target, not a hard ceiling. Omit it for the mode's normal speed; a larger value (e.g. 30000) lets slower sources run longer, so deep/exhaustive searches can take close to that long. The search may run a little past it when it needs a moment more to return a useful page. Requested page text (content/extracts) is fetched afterward, on top of the target. Values below 1000 are raised to 1000; values above 30000 are lowered to 30000; 0, empty or non-numeric values are ignored. With searchMode=auto (the default), a timeout steps the resolved mode down to the richest one that fits it. An explicit searchMode is always honored.
Required range: 1000 <= x <= 30000
safe
enum<string>
default:off
Safe search filtering level. off disables filtering, moderate filters most explicit content, strict applies maximum filtering.
Available options:
off,
moderate,
strict
country
string
default:US
Two-letter ISO 3166-1 country code to localize results. When you name a country, its main languages also count as target languages for ranking and for languageMode=strict. It does not narrow what Andi retrieves.
sourceCountry
string
Two-letter ISO 3166-1 country code to restrict results to sources from this country. Unlike country, which biases results by locale, sourceCountry excludes results from other countries.
language
string
Language tag for the search, up to 13 characters. Accepts a primary language with optional region or script subtags, for example en, de, zh-Hans or es-419; matching uses the primary subtag. Omit it and Andi detects the query language. A language you state is used for language filtering, ranking, reranking and page retrieval. The lang: query operator takes precedence. The language Andi used is returned in locale.
Maximum string length: 13
languageMode
enum<string>
default:prefer
How strictly to hold results to the target languages. prefer ranks pages in the query language first. strict also drops pages whose known language is neither a target language nor English; pages with an unknown language are kept. It changes the response only, never what is cached. Target languages are the query language plus, when you name a country, that country's main languages.
Available options:
prefer,
strict
units
enum<string>
Unit system for weather and calculation results. Defaults based on the country parameter — imperial for US, metric for all other countries.
Available options:
metric,
imperial
noCache
boolean
default:false
Bypass cached results and fetch fresh data.
dateRange
enum<string>
Relative date range filter for results.
Available options:
day,
week,
month,
year,
24h,
7d,
30d,
90d,
1y
dateFrom
string<date>
Filter results published on or after this date. Format: YYYY-MM-DD.
dateTo
string<date>
Filter results published on or before this date. Format: YYYY-MM-DD.
includeDomains
string
Comma-separated list of domains to restrict results to. Supports wildcards (*.example.com).
excludeDomains
string
Comma-separated list of domains to exclude from results. Supports wildcards.
includeTerms
string
Comma-separated terms that must appear in results.
excludeTerms
string
Comma-separated terms to exclude from results.
parseOperators
boolean
default:true
Parse query operators (like site:, filetype:, intitle:) from the query string. When disabled, the query is treated as literal text.
linkFormat
enum<string>
default:link
Field name for result URLs. Use url to receive the URL field as url instead of the default link. Only affects the /search endpoint.
Available options:
link,
url
imageFormat
enum<string>
default:long
Field naming for image results. long (default) uses full field names. short uses abbreviated field names.
Available options:
short,
long
filetype
string
Filter results by file type.
intitle
string
Filter results to pages with this term in the title.
inurl
string
Filter results to pages with this term in the URL.
intext
string
Filter results to pages with this term in the body text.
latitude
number
Latitude in decimal degrees. Sent in the body to keep coordinates out of HTTP access logs.
longitude
number
Longitude in decimal degrees.
accuracy
number
Location accuracy in meters.
city
string
City name for location-aware queries.
state
string
State or region name.
countryCode
string
Two-letter ISO 3166-1 country code for the caller's location.
postalCode
string
Postal or ZIP code.
timezone
string
IANA timezone, for example America/Los_Angeles.
location
string
Display name for the caller's location, for example "San Francisco, CA".
Response
Search results. JSON by default; LLM-ready markdown with YAML frontmatter when format=context.
results_type
string
required
The type of results returned (e.g., Search, News, Weather, Calculator, TimeZone, Currency, Answer). Determines which optional response sections are present.
answer
string
required
Instant answer for the query when one is found — for example a definition, a weather line or a calculation — otherwise an empty string. On news feeds, a short summary of the headlines when available.
type
string
required
Same as results_type. Indicates the category of results.
title
string
required
Your query text (for a news feed, the feed's description).
results
object[]
required
Array of search results. Only rows with a web address appear; answers with no address (calculator, clock, currency, translation, quote, score) are in answer and their block.
Show child attributes
metrics
object
required
Search performance metrics. Always included in the response.
Show child attributes
answer_metadata
object
How the answer was made. kind is extractive, instant or llm; citations are the links of the rows it came from; passage is where on the row a quote came from; block (instant answers) names the response field that holds the answer's data (such as weather, calculation, time, currency, quote, score). It points to that field and never copies it. data appears only for a value that exists nowhere else, such as an extracted value.
Show child attributes
correctedQuery
string
Spell-corrected query. Present when a misspelling in the original query is detected and corrected — any mode can return it; deep and exhaustive modes run the strongest spell correction.
related_searches
string[]
Related search suggestions. Present on some queries.
topics
string[]
Related topics. Present on some queries.
related_topics
string[]
Related topic names for entity answers.
infobox
object
Facts panel for an entity answer.
Show child attributes
aiSummary
object
A pre-written news summary. News feeds return it, and so does search when the query asks for a whole feed (for example "latest technology news" or "hacker news"), but not for a topic inside a feed ("nfl news"). On news feeds the same text is in answer; on search, answer can hold something else, such as a description of the site.
Show child attributes
filter_counts
object
Present when an author or publisher filter is set: how many shown results match it and how many have no known author or publisher.
Show child attributes
locale
object
The language and country Andi searched for. Present on every search response (not on news feeds). With format=context, the same values appear in the frontmatter as language, language_confidence, language_source, country and local_scope.
Show child attributes
safeSearch
object
Echo of the safe-search state. Present on cache misses. Use it to confirm your safe parameter was honored.
Show child attributes
videos
object[]
Video results, when the search found any.
Show child attributes
images
object[]
Image results, when the search found any.
Show child attributes
news
object[]
News stories, when the search found any. Front pages, section pages, topic pages and listing pages are in categories, not here.
Show child attributes
citations
object[]
Rows an answer cites, in the same shape as results. When a search names a whole curated news feed (for example "headlines" or "latest news from hacker news") and the response carries the feed's aiSummary, this lists the stories the summary cites in the summary's order, then the feed's other stories, up to limit. Left out when empty. Not on /api/v1/news.
Show child attributes
categories
object[]
News front pages, section pages, topic or tag pages, listing pages and site-search pages. results still holds them too. Left out when empty. Not on /api/v1/news.
Show child attributes
places
object[]
Place and business results, when the search found any.
Show child attributes
profiles
object[]
People and entity profiles, when the search found any.
Show child attributes
social
object[]
Social posts, when the search found any.
Show child attributes
academic
object[]
Scholarly papers, when the search found any.
Show child attributes
weather
object
Weather data. Present when the query triggers a weather intent.
Show child attributes
calculation
object
Calculation result. Present when the query triggers a calculation intent.
Show child attributes
preset
object
Which preset ran, how it was chosen and the defaults it filled in. Present only when a preset was chosen by preset= or by the calling surface (MCP server, CLI).
Show child attributes
warnings
string[]
Notes on parts of the request the API adjusted or ignored, for example a limit above 10 lowered to 10 on instant.
time
object
Present when the query is a time or clock query.
Show child attributes
currency
object
Present when the query is a currency conversion query.
Show child attributes
translation
object
Present when the query is a translation query.
Show child attributes
quote
object
Present when the query is a share price query.
Show child attributes
score
object
Present when the query is a game score query.
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Andi AI Search API Docs","colors":{"primary":"#3B75FA","light":"#4A9FFF","dark":"#2D5FD4"},"logo":{"light":"https://mintcdn.com/andi-8668c890/iAUOg-iw6vgsM_eb/logo/light.png?fit=max\u0026auto=format\u0026n=iAUOg-iw6vgsM_eb\u0026q=85\u0026s=214638eda335536c18a177e7535fbaf3","dark":"https://mintcdn.com/andi-8668c890/iAUOg-iw6vgsM_eb/logo/dark.png?fit=max\u0026auto=format\u0026n=iAUOg-iw6vgsM_eb\u0026q=85\u0026s=e899261a433ec63ecebc0a1b7e4f2fa6"},"favicon":"https://mintcdn.com/andi-8668c890/KcXM0V6rREN26pNL/favicon.svg?fit=max\u0026auto=format\u0026n=KcXM0V6rREN26pNL\u0026q=85\u0026s=7c2aca5507f94e2951e0329e373303f1","api":{"playground":{}},"background":{"decoration":"gradient"},"navbar":{"links":[{"href":"mailto:hello+api@andiai.com","label":"Support"}],"primary":{"type":"button","label":"API Console","href":"https://console.andiai.com"}},"footer":{"socials":{"x":"https://x.com/andi_search","linkedin":"https://linkedin.com/company/andisearch","github":"https://github.com/andisearch","discord":"https://discord.gg/J2NJ2rj7ax"},"links":[{"header":"Resources","items":[{"label":"System Status","href":"https://status.andiai.com"}]}]},"seo":{"metatags":{"og:site_name":"Andi AI Search API Docs","twitter:site":"@andi_search"}},"integrations":{"posthog":{"apiKey":"phc_afElmpLLyofAdfYVvGJJYmSShyMjX8uMOHtGaaKolOe","sessionRecording":true}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"thumbnails":{"appearance":"dark","background":"https://mintcdn.com/andi-8668c890/nLd8HaNhhK_YSNIf/images/og-default.png?fit=max\u0026auto=format\u0026n=nLd8HaNhhK_YSNIf\u0026q=85\u0026s=1bdc6ffe8c290f6e4bbfcba8e7977f12"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"AndiAI.com","icon":"globe","href":"https://andiai.com"},{"anchor":"API Console","icon":"terminal","href":"https://console.andiai.com"},{"anchor":"Andi Search","icon":"magnifying-glass","href":"https://andisearch.com"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"andi-8668c890","hasAudioNarration":false,"actualSubdomain":"andi-8668c890","customDomains":["docs.andiai.com"],"gitSource":{"type":"github","owner":"andisearch","repo":"andi-api-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6b0245ffd48387065b200bec","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"Documentation","count":17},{"language":"default","tag":"API reference","count":7},{"language":"default","tag":"Getting started","count":7},{"language":"default","tag":"Endpoints","count":6},{"language":"default","tag":"API Reference","count":6},{"language":"default","tag":"Examples","count":5},{"language":"default","tag":"Search","count":5},{"language":"default","tag":"Use cases","count":4},{"language":"default","tag":"Features","count":4},{"language":"default","tag":"Resources","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"html.dark a.nav-anchor:hover svg{background-color:#ffffff!important}html.dark a.nav-anchor:hover>div{filter:brightness(1)!important}"}]}
{"page":{"pagePath":"api-reference/search-the-web-json-body","slug":"/api-reference/search-the-web-json-body","pageMetadata":{"title":"Search the web (JSON body)","description":"Same contract as `GET /api/v1/search`, but accepts parameters as a JSON body. Preferred for location-bearing requests because GET-style location encoding is awkward and keeps `latitude`/`longitude` out of HTTP access logs. All GET query parameters are accepted as body fields, plus optional location fields (`latitude`, `longitude`, `accuracy`, `city`, `state`, `countryCode`, `postalCode`, `timezone`, `location`).","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/search","href":"/api-reference/search-the-web-json-body","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Same contract as \", _jsx(_components.code, {\n children: \"GET /api/v1/search\"\n }), \", but accepts parameters as a JSON body. Preferred for location-bearing requests because GET-style location encoding is awkward and keeps \", _jsx(_components.code, {\n children: \"latitude\"\n }), \"/\", _jsx(_components.code, {\n children: \"longitude\"\n }), \" out of HTTP access logs. All GET query parameters are accepted as body fields, plus optional location fields (\", _jsx(_components.code, {\n children: \"latitude\"\n }), \", \", _jsx(_components.code, {\n children: \"longitude\"\n }), \", \", _jsx(_components.code, {\n children: \"accuracy\"\n }), \", \", _jsx(_components.code, {\n children: \"city\"\n }), \", \", _jsx(_components.code, {\n children: \"state\"\n }), \", \", _jsx(_components.code, {\n children: \"countryCode\"\n }), \", \", _jsx(_components.code, {\n children: \"postalCode\"\n }), \", \", _jsx(_components.code, {\n children: \"timezone\"\n }), \", \", _jsx(_components.code, {\n children: \"location\"\n }), \").\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Search the web (JSON body)","description":"Same contract as `GET /api/v1/search`, but accepts parameters as a JSON body. Preferred for location-bearing requests because GET-style location encoding is awkward and keeps `latitude`/`longitude` out of HTTP access logs. All GET query parameters are accepted as body fields, plus optional location fields (`latitude`, `longitude`, `accuracy`, `city`, `state`, `countryCode`, `postalCode`, `timezone`, `location`).","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/search","href":"/api-reference/search-the-web-json-body","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/andi-8668c890/0facf08817720e0f/organization-schema.js"],"openApiReferenceData":{"operation":{"operationId":"searchPost","summary":"Search the web (JSON body)","description":"Same contract as `GET /api/v1/search`, but accepts parameters as a JSON body. Preferred for location-bearing requests because GET-style location encoding is awkward and keeps `latitude`/`longitude` out of HTTP access logs. All GET query parameters are accepted as body fields, plus optional location fields (`latitude`, `longitude`, `accuracy`, `city`, `state`, `countryCode`, `postalCode`, `timezone`, `location`).","requestBody":"b2826941-c49e-4bab-89a8-7f8353ca05b5","responses":{"200":"abc33194-5cb6-4807-b21e-5fefda26664a","400":"fdc9c827-78f1-4648-b646-a794331edf18","401":"8fb648cf-6e0c-4313-8b77-2cc0f8f16234","402":"e427a9cb-7f72-4ac1-98b7-9359082f5813","429":"dfe75424-2c02-4f85-ba6e-d0b7ea58ed1d","500":"de0850a6-7f9b-4463-9f10-29c473a02368"},"method":"post","type":"path","servers":["f4c490a4-487c-4a06-a011-49eb71d9c3f3"],"security":["7bd5246a-74fa-40af-970d-a3f0ce08bb16"],"path":"/api/v1/search","baseUrlOptions":["https://api.andiai.com"],"title":"Search the web (JSON body)","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["q"],"properties":{"q":{"type":"string","description":"Search query string. Same semantics as the GET `q` parameter.","isRequired":true,"uniqueKey":"q","typeLabel":"string"},"limit":{"type":"integer","minimum":1,"maximum":100,"description":"Maximum number of results to return. When omitted, a single-query search returns 10–40 results picked to fit the query (fewer for a site or a fact, more for news, lists, documentation and research); 20 with `offset` or for multi-query. Set `limit` for a fixed count.","uniqueKey":"limit","typeLabel":"integer"},"offset":{"type":"integer","default":0,"minimum":0,"description":"Number of results to skip for pagination.","uniqueKey":"offset","typeLabel":"integer"},"searchMode":{"type":"string","enum":["auto","instant","low-cost","fast","balanced","deep","exhaustive"],"default":"auto","description":"Search effort control. `auto` (default) sets the effort per query automatically — simple lookups resolve fast, complex questions get deeper treatment. The fixed modes pin an effort level: `instant` puts speed first, returns at most 10 results and no page content, and is never chosen by `auto`. `low-cost` caps the work done per request for budget-constrained callers. `fast` returns results in about 2 seconds. `balanced` is everyday web search, about 4–5 seconds. `deep` searches from multiple angles with spell correction, about 6.5 seconds. `exhaustive` is Andi's most thorough mode: more sources and more time, up to about 15 seconds; for a question with several parts or steps it searches each part. Deeper modes add query expansion, follow-up searches fanned out from initial results, and stronger reranking. Requests are billed on outcome-based pricing (see `metrics.cost_dollars`).","uniqueKey":"searchMode","typeLabel":"enum\u003cstring>"},"effort":{"type":"string","enum":["low","medium","high","max"],"description":"Thoroughness dial, independent of `searchMode`: `low` favors speed, `medium` is balanced, `high` searches from multiple angles with spell correction, `max` gives the most complete results and also searches each part of a question that has several parts or steps — the same tiers as pinning `searchMode` to `fast`, `balanced`, `deep`, and `exhaustive` respectively. An explicit `searchMode` always wins over `effort`. With the default `auto` mode, an explicit `effort` pins its equivalent mode. Omit for the adaptive default. Invalid values return a `400` listing the valid tiers.","uniqueKey":"effort","typeLabel":"enum\u003cstring>"},"reranker":{"type":"string","enum":["auto","small","medium","large","xl"],"default":"auto","description":"Semantic reranker size hint. `small` is the lightest and fastest; `medium` and above apply stronger relevance scoring but need a deeper `searchMode` and may be clamped by the request's time and cost budget (for example, `xl` needs `deep` or `exhaustive`). `auto` (default) selects a tier automatically based on the query and search mode.","uniqueKey":"reranker","typeLabel":"enum\u003cstring>"},"intent":{"type":"string","description":"Force a specific search intent. When not set, the API auto-detects intent from the query. Accepts common aliases like `search`, `news`, `video`, `images`, `weather`, `wiki`, `code`, `recipe`, `place`, `time`, and others.","uniqueKey":"intent","typeLabel":"string"},"format":{"type":"string","enum":["json","context"],"default":"json","description":"Response format. `json` returns a JSON object. `context` returns results as markdown text, suitable for passing to language models.","uniqueKey":"format","typeLabel":"enum\u003cstring>"},"metadata":{"type":"string","enum":["basic","full"],"default":"basic","description":"Level of metadata to include. `basic` includes standard search metrics. `full` includes extended metadata with content type details and reader data on results.","uniqueKey":"metadata","typeLabel":"enum\u003cstring>"},"extracts":{"type":"boolean","default":false,"description":"Include text extracts from result pages in the response. Defaults to `true` when `format=context`, `content=true` or `content=focused`; pass `extracts=false` to turn them off in those cases. Also returned by default with `metadata=full`.","uniqueKey":"extracts","typeLabel":"boolean"},"content":{"oneOf":[{"type":"boolean","description":"Include each result's full page text, in `reader.markdown` (or `reader.content` when the page has no markdown version). `true` returns the head of each page. `\"focused\"` returns the parts of each page that answer the query, in page order under section headings; it is billed and capped like `true` and falls back to the normal page text when no focused text can be built. Any other value is treated as `false`. Also turns on `extracts` unless `extracts=false` is passed. Adds time and cost; deeper modes allow more time.","default":false,"uniqueKey":"content.oneOf.0","typeLabel":"boolean"},{"type":"string","description":"Include each result's full page text, in `reader.markdown` (or `reader.content` when the page has no markdown version). `true` returns the head of each page. `\"focused\"` returns the parts of each page that answer the query, in page order under section headings; it is billed and capped like `true` and falls back to the normal page text when no focused text can be built. Any other value is treated as `false`. Also turns on `extracts` unless `extracts=false` is passed. Adds time and cost; deeper modes allow more time.","default":false,"enum":["true","focused","false"],"uniqueKey":"content.oneOf.1","typeLabel":"enum\u003cstring>"}],"uniqueKey":"content","typeLabel":"boolean | enum\u003cstring>"},"enrichContent":{"type":"boolean","default":false,"deprecated":true,"description":"Deprecated alias of `content`.","uniqueKey":"enrichContent","typeLabel":"boolean"},"maxContentLength":{"type":"integer","description":"Maximum number of characters of page text to return per result. Only applies when `content` is true.","uniqueKey":"maxContentLength","typeLabel":"integer"},"preset":{"type":"string","enum":["app","agent"],"description":"Named set of defaults: `app` (the API's ordinary defaults; used for direct calls) or `agent` (context format, focused page content, extracts, a 16,000-token budget; used by the MCP server and CLI). A preset fills only parameters you did not send, so any parameter you send wins. The reply states the preset when one was chosen (`preset` in JSON, a `preset` line in the context frontmatter).","uniqueKey":"preset","typeLabel":"enum\u003cstring>"},"maxTokens":{"type":"integer","minimum":1000,"maximum":200000,"description":"Token budget for the results (1,000 to 200,000). Results with page content fill it first, then results with extracts, then snippets; results that do not fit are dropped from the bottom, keeping rank order, and any result shown in part carries `truncated`, `shown_words` and `total_words`. Default 16,000 with `format=context` and `content=focused` (24,000 on `deep` and `exhaustive`); on other output it applies only when sent.","uniqueKey":"maxTokens","typeLabel":"integer"},"timeout":{"type":"integer","minimum":1000,"maximum":30000,"description":"Target time in milliseconds for ranked results (1000–30000). It is a target, not a hard ceiling. Omit it for the mode's normal speed; a larger value (e.g. 30000) lets slower sources run longer, so deep/exhaustive searches can take close to that long. The search may run a little past it when it needs a moment more to return a useful page. Requested page text (`content`/`extracts`) is fetched afterward, on top of the target. Values below 1000 are raised to 1000; values above 30000 are lowered to 30000; 0, empty or non-numeric values are ignored. With `searchMode=auto` (the default), a timeout steps the resolved mode down to the richest one that fits it. An explicit `searchMode` is always honored.","uniqueKey":"timeout","typeLabel":"integer"},"safe":{"type":"string","enum":["off","moderate","strict"],"default":"off","description":"Safe search filtering level. `off` disables filtering, `moderate` filters most explicit content, `strict` applies maximum filtering.","uniqueKey":"safe","typeLabel":"enum\u003cstring>"},"country":{"type":"string","default":"US","description":"Two-letter ISO 3166-1 country code to localize results. When you name a country, its main languages also count as target languages for ranking and for `languageMode=strict`. It does not narrow what Andi retrieves.","uniqueKey":"country","typeLabel":"string"},"sourceCountry":{"type":"string","description":"Two-letter ISO 3166-1 country code to restrict results to sources from this country. Unlike `country`, which biases results by locale, `sourceCountry` excludes results from other countries.","uniqueKey":"sourceCountry","typeLabel":"string"},"language":{"type":"string","maxLength":13,"description":"Language tag for the search, up to 13 characters. Accepts a primary language with optional region or script subtags, for example `en`, `de`, `zh-Hans` or `es-419`; matching uses the primary subtag. Omit it and Andi detects the query language. A language you state is used for language filtering, ranking, reranking and page retrieval. The `lang:` query operator takes precedence. The language Andi used is returned in `locale`.","uniqueKey":"language","typeLabel":"string"},"languageMode":{"type":"string","enum":["prefer","strict"],"default":"prefer","description":"How strictly to hold results to the target languages. `prefer` ranks pages in the query language first. `strict` also drops pages whose known language is neither a target language nor English; pages with an unknown language are kept. It changes the response only, never what is cached. Target languages are the query language plus, when you name a `country`, that country's main languages.","uniqueKey":"languageMode","typeLabel":"enum\u003cstring>"},"units":{"type":"string","enum":["metric","imperial"],"description":"Unit system for weather and calculation results. Defaults based on the `country` parameter — `imperial` for `US`, `metric` for all other countries.","uniqueKey":"units","typeLabel":"enum\u003cstring>"},"noCache":{"type":"boolean","default":false,"description":"Bypass cached results and fetch fresh data.","uniqueKey":"noCache","typeLabel":"boolean"},"dateRange":{"type":"string","enum":["day","week","month","year","24h","7d","30d","90d","1y"],"description":"Relative date range filter for results.","uniqueKey":"dateRange","typeLabel":"enum\u003cstring>"},"dateFrom":{"type":"string","format":"date","description":"Filter results published on or after this date. Format: `YYYY-MM-DD`.","uniqueKey":"dateFrom","typeLabel":"string\u003cdate>"},"dateTo":{"type":"string","format":"date","description":"Filter results published on or before this date. Format: `YYYY-MM-DD`.","uniqueKey":"dateTo","typeLabel":"string\u003cdate>"},"includeDomains":{"type":"string","description":"Comma-separated list of domains to restrict results to. Supports wildcards (`*.example.com`).","uniqueKey":"includeDomains","typeLabel":"string"},"excludeDomains":{"type":"string","description":"Comma-separated list of domains to exclude from results. Supports wildcards.","uniqueKey":"excludeDomains","typeLabel":"string"},"includeTerms":{"type":"string","description":"Comma-separated terms that must appear in results.","uniqueKey":"includeTerms","typeLabel":"string"},"excludeTerms":{"type":"string","description":"Comma-separated terms to exclude from results.","uniqueKey":"excludeTerms","typeLabel":"string"},"parseOperators":{"type":"boolean","default":true,"description":"Parse query operators (like `site:`, `filetype:`, `intitle:`) from the query string. When disabled, the query is treated as literal text.","uniqueKey":"parseOperators","typeLabel":"boolean"},"linkFormat":{"type":"string","enum":["link","url"],"default":"link","description":"Field name for result URLs. Use `url` to receive the URL field as `url` instead of the default `link`. Only affects the `/search` endpoint.","uniqueKey":"linkFormat","typeLabel":"enum\u003cstring>"},"imageFormat":{"type":"string","enum":["short","long"],"default":"long","description":"Field naming for image results. `long` (default) uses full field names. `short` uses abbreviated field names.","uniqueKey":"imageFormat","typeLabel":"enum\u003cstring>"},"filetype":{"type":"string","description":"Filter results by file type.","uniqueKey":"filetype","typeLabel":"string"},"intitle":{"type":"string","description":"Filter results to pages with this term in the title.","uniqueKey":"intitle","typeLabel":"string"},"inurl":{"type":"string","description":"Filter results to pages with this term in the URL.","uniqueKey":"inurl","typeLabel":"string"},"intext":{"type":"string","description":"Filter results to pages with this term in the body text.","uniqueKey":"intext","typeLabel":"string"},"latitude":{"type":"number","description":"Latitude in decimal degrees. Sent in the body to keep coordinates out of HTTP access logs.","uniqueKey":"latitude","typeLabel":"number"},"longitude":{"type":"number","description":"Longitude in decimal degrees.","uniqueKey":"longitude","typeLabel":"number"},"accuracy":{"type":"number","description":"Location accuracy in meters.","uniqueKey":"accuracy","typeLabel":"number"},"city":{"type":"string","description":"City name for location-aware queries.","uniqueKey":"city","typeLabel":"string"},"state":{"type":"string","description":"State or region name.","uniqueKey":"state","typeLabel":"string"},"countryCode":{"type":"string","description":"Two-letter ISO 3166-1 country code for the caller's location.","uniqueKey":"countryCode","typeLabel":"string"},"postalCode":{"type":"string","description":"Postal or ZIP code.","uniqueKey":"postalCode","typeLabel":"string"},"timezone":{"type":"string","description":"IANA timezone, for example America/Los_Angeles.","uniqueKey":"timezone","typeLabel":"string"},"location":{"type":"string","description":"Display name for the caller's location, for example \"San Francisco, CA\".","uniqueKey":"location","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"q":"best italian restaurants near me","limit":10,"city":"San Francisco","state":"California","countryCode":"US","latitude":37.7794,"longitude":-122.4176},"examples":{"Example":{"title":"Example","value":{"q":"best italian restaurants near me","limit":10,"city":"San Francisco","state":"California","countryCode":"US","latitude":37.7794,"longitude":-122.4176}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"abc33194-5cb6-4807-b21e-5fefda26664a":{"description":"Search results. JSON by default; LLM-ready markdown with YAML frontmatter when `format=context`.","content":{"application/json":{"schema":{"type":"object","properties":{"results_type":{"type":"string","description":"The type of results returned (e.g., `Search`, `News`, `Weather`, `Calculator`, `TimeZone`, `Currency`, `Answer`). Determines which optional response sections are present.","isRequired":true,"uniqueKey":"results_type","typeLabel":"string"},"answer":{"type":"string","description":"Instant answer for the query when one is found — for example a definition, a weather line or a calculation — otherwise an empty string. On news feeds, a short summary of the headlines when available.","isRequired":true,"uniqueKey":"answer","typeLabel":"string"},"type":{"type":"string","description":"Same as `results_type`. Indicates the category of results.","isRequired":true,"uniqueKey":"type","typeLabel":"string"},"title":{"type":"string","description":"Your query text (for a news feed, the feed's description).","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"results":{"type":"array","description":"Array of search results. Only rows with a web address appear; answers with no address (calculator, clock, currency, translation, quote, score) are in `answer` and their block.","items":{"type":"object","properties":{"title":{"type":"string","description":"Page title.","isRequired":true,"uniqueKey":"results.items.[INDEX].title","typeLabel":"string"},"link":{"type":"string","format":"uri","description":"Page URL.","isRequired":true,"uniqueKey":"results.items.[INDEX].link","typeLabel":"string\u003curi>"},"desc":{"type":"string","description":"Page description or summary.","isRequired":true,"uniqueKey":"results.items.[INDEX].desc","typeLabel":"string"},"source":{"type":"string","description":"Site or publisher name (for example `Wikipedia`); a name derived from the domain when none is known.","isRequired":true,"uniqueKey":"results.items.[INDEX].source","typeLabel":"string"},"type":{"type":"string","description":"Result type. Only included when `metadata=full`.","enum":["website","blog","news","video","image","place","profile","social","academic","calculation","weather","computation","instant answer"],"uniqueKey":"results.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"date":{"type":"string","description":"Publication date of the content, when available.","uniqueKey":"results.items.[INDEX].date","typeLabel":"string"},"dateModified":{"type":"string","description":"When the page was last updated, if known.","uniqueKey":"results.items.[INDEX].dateModified","typeLabel":"string"},"image":{"type":"string","format":"uri","description":"Preview image URL, when available. Only included when `metadata=full`.","uniqueKey":"results.items.[INDEX].image","typeLabel":"string\u003curi>"},"snippet":{"type":"string","description":"Query-relevant text excerpt from the page. Distinct from `desc`, which is the general page description.","uniqueKey":"results.items.[INDEX].snippet","typeLabel":"string"},"answer":{"type":"string","description":"Inline answer for instant answer results.","uniqueKey":"results.items.[INDEX].answer","typeLabel":"string"},"extracts":{"type":"array","items":{"type":"string","uniqueKey":"results.items.[INDEX].extracts.items.[INDEX]","typeLabel":"string"},"description":"Query-relevant passages from the page. Returned with `extracts=true`, and by default with `format=context`, `content=true` and `metadata=full`.","uniqueKey":"results.items.[INDEX].extracts","typeLabel":"string[]"},"contentType":{"type":"string","description":"Content type of the page. Only included when `metadata=full`.","uniqueKey":"results.items.[INDEX].contentType","typeLabel":"string"},"reader":{"type":"object","description":"Extracted page content and metadata. Included with `metadata=full`; with `content=true` it holds the full page text in `reader.markdown` (or `reader.content`) at any metadata level.","uniqueKey":"results.items.[INDEX].reader","typeLabel":"object"},"contentSafety":{"type":"object","description":"Safety classification. Only included when `metadata=full`.","properties":{"rating":{"type":"string","enum":["safe","unsafe","unknown"],"description":"Content safety rating.","uniqueKey":"results.items.[INDEX].contentSafety.rating","typeLabel":"enum\u003cstring>"},"safeSearchApplied":{"type":"boolean","description":"Whether safe-search filtering was applied to this result.","uniqueKey":"results.items.[INDEX].contentSafety.safeSearchApplied","typeLabel":"boolean"}},"uniqueKey":"results.items.[INDEX].contentSafety","typeLabel":"object"},"bang":{"type":"string","description":"Bang shortcut for the result domain. Only included when `metadata=full`.","uniqueKey":"results.items.[INDEX].bang","typeLabel":"string"},"queryIndices":{"type":"array","items":{"type":"integer","uniqueKey":"results.items.[INDEX].queryIndices.items.[INDEX]","typeLabel":"integer"},"description":"Multi-query only: which of your queries (0-based) found this result.","uniqueKey":"results.items.[INDEX].queryIndices","typeLabel":"integer[]"},"language":{"type":"string","description":"The page's language as a lower-case primary tag, for example `fr`. Left out when unknown.","uniqueKey":"results.items.[INDEX].language","typeLabel":"string"},"site_country":{"type":"string","description":"ISO 3166-1 country code named by the site's country-code domain, for example `DE` for `.de`. Generic domains such as `.com` have none.","uniqueKey":"results.items.[INDEX].site_country","typeLabel":"string"},"availability":{"type":"object","description":"Present only when something is wrong with the site or this page. `link` is never changed. Left out for healthy results.","properties":{"state":{"type":"string","enum":["redirected","parked","repurposed","hijacked","likely_dead","dead","gone"],"description":"`redirected`: the site has moved (see `movedTo`). `parked`: the domain is parked or for sale. `repurposed`: the domain now hosts unrelated content. `hijacked`: the domain was taken over. `likely_dead`: repeated checks over weeks failed. `dead`: the site is confirmed offline. `gone`: this one page was removed.","isRequired":true,"uniqueKey":"results.items.[INDEX].availability.state","typeLabel":"enum\u003cstring>"},"scope":{"type":"string","enum":["site","page"],"description":"`site` when the whole site is affected, `page` when only this page is (`gone`).","isRequired":true,"uniqueKey":"results.items.[INDEX].availability.scope","typeLabel":"enum\u003cstring>"},"source":{"type":"string","enum":["probe","rdap","origin","curated","page"],"description":"Who decided: Andi's own site checks (`probe`), the domain registry (`rdap`), the page's own server (`origin`), a curated list (`curated`), or the result's own title and snippet, which read as a parked or for-sale page (`page`).","isRequired":true,"uniqueKey":"results.items.[INDEX].availability.source","typeLabel":"enum\u003cstring>"},"since":{"type":"string","format":"date-time","description":"When the state was first seen, when known.","uniqueKey":"results.items.[INDEX].availability.since","typeLabel":"string\u003cdate-time>"},"checkedAt":{"type":"string","format":"date-time","description":"When the state was last checked, when known.","uniqueKey":"results.items.[INDEX].availability.checkedAt","typeLabel":"string\u003cdate-time>"},"movedTo":{"type":"string","description":"Host the site moved to. Only with `state: redirected`.","uniqueKey":"results.items.[INDEX].availability.movedTo","typeLabel":"string"}},"required":["state","scope","source"],"uniqueKey":"results.items.[INDEX].availability","typeLabel":"object"},"archive":{"type":"array","description":"Saved copies of this exact page, newest first; the first entry is the best one. Present only on results that have `availability`.","items":{"type":"object","properties":{"source":{"type":"string","description":"Where the copy is kept: `wayback` (Internet Archive) or `andi` (Andi's own stored copy).","isRequired":true,"uniqueKey":"results.items.[INDEX].archive.items.[INDEX].source","typeLabel":"string"},"url":{"oneOf":[{"type":"string","description":"Public address of the copy. `null` for Andi's own copy, which has no public address: read it with the fetch endpoint using the result's `link`.","isRequired":true,"uniqueKey":"results.items.[INDEX].archive.items.[INDEX].url.oneOf.0","typeLabel":"string"},{"type":"null","description":"Public address of the copy. `null` for Andi's own copy, which has no public address: read it with the fetch endpoint using the result's `link`.","isRequired":true,"uniqueKey":"results.items.[INDEX].archive.items.[INDEX].url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.items.[INDEX].archive.items.[INDEX].url","typeLabel":"string | null"},"capturedAt":{"type":"string","format":"date-time","description":"When the copy was saved.","uniqueKey":"results.items.[INDEX].archive.items.[INDEX].capturedAt","typeLabel":"string\u003cdate-time>"}},"required":["source","url"],"uniqueKey":"results.items.[INDEX].archive.items.[INDEX]","typeLabel":"object"},"uniqueKey":"results.items.[INDEX].archive","typeLabel":"object[]"},"seeAlso":{"type":"array","description":"News feeds only: other outlets covering the same story.","items":{"type":"object","properties":{"title":{"type":"string","uniqueKey":"results.items.[INDEX].seeAlso.items.[INDEX].title","typeLabel":"string"},"url":{"type":"string","format":"uri","uniqueKey":"results.items.[INDEX].seeAlso.items.[INDEX].url","typeLabel":"string\u003curi>"},"source":{"type":"string","uniqueKey":"results.items.[INDEX].seeAlso.items.[INDEX].source","typeLabel":"string"}},"uniqueKey":"results.items.[INDEX].seeAlso.items.[INDEX]","typeLabel":"object"},"uniqueKey":"results.items.[INDEX].seeAlso","typeLabel":"object[]"},"truncated":{"type":"boolean","description":"`true` when the result shows less page text than the page holds (cut to fit `maxTokens`, or focused to the parts that answer the query). A result with only a snippet or extracts is marked only when the budget cut it. Fetch the page's URL for the rest.","uniqueKey":"results.items.[INDEX].truncated","typeLabel":"boolean"},"shown_words":{"type":"integer","description":"Words of page text this result shows. Present with `truncated`.","uniqueKey":"results.items.[INDEX].shown_words","typeLabel":"integer"},"total_words":{"type":"integer","description":"Words the whole page holds. Present with `truncated`.","uniqueKey":"results.items.[INDEX].total_words","typeLabel":"integer"}},"required":["title","link","desc","source"],"uniqueKey":"results.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"results","typeLabel":"object[]"},"metrics":{"type":"object","description":"Search performance metrics. Always included in the response.","properties":{"query":{"type":"string","description":"The query as processed.","uniqueKey":"metrics.query","typeLabel":"string"},"intent":{"type":"string","description":"The detected or forced search intent.","uniqueKey":"metrics.intent","typeLabel":"string"},"timestamp":{"type":"string","description":"Timestamp of the search request.","uniqueKey":"metrics.timestamp","typeLabel":"string"},"duration":{"type":"number","description":"Total request duration in milliseconds.","uniqueKey":"metrics.duration","typeLabel":"number"},"queries_executed":{"type":"integer","description":"Number of search queries executed.","uniqueKey":"metrics.queries_executed","typeLabel":"integer"},"api_requests_count":{"type":"integer","description":"Number of queries in your request (the same as `queries_executed`).","uniqueKey":"metrics.api_requests_count","typeLabel":"integer"},"results_returned":{"type":"integer","description":"Number of results returned in this response.","uniqueKey":"metrics.results_returned","typeLabel":"integer"},"total_results_found":{"type":"integer","description":"Rough estimate of matching pages, as reported by sources (0 for news feeds).","uniqueKey":"metrics.total_results_found","typeLabel":"integer"},"queries_provided":{"type":"integer","description":"Number of queries you sent. Only present when more than 5 were sent.","uniqueKey":"metrics.queries_provided","typeLabel":"integer"},"queries_truncated":{"type":"integer","description":"How many queries were dropped because only the first 5 run. Only present when more than 5 were sent.","uniqueKey":"metrics.queries_truncated","typeLabel":"integer"},"cached":{"type":"boolean","description":"Whether the response was served from cache. Only present on cache hits.","uniqueKey":"metrics.cached","typeLabel":"boolean"},"cache_age_seconds":{"type":"integer","description":"Age of the cached response in seconds. Only present on cache hits.","uniqueKey":"metrics.cache_age_seconds","typeLabel":"integer"},"built_at":{"type":"string","description":"News topic pages only. When the page was built, as an ISO 8601 time.","uniqueKey":"metrics.built_at","typeLabel":"string"},"max_age_seconds":{"type":"integer","description":"News topic pages only. How old the page may get before it is rebuilt while you wait.","uniqueKey":"metrics.max_age_seconds","typeLabel":"integer"},"stale":{"type":"boolean","description":"News topic pages only. `true` when the page could not be refreshed and this is the last good copy.","uniqueKey":"metrics.stale","typeLabel":"boolean"},"cost_dollars":{"type":"number","description":"Amount charged to your account for this request in USD, after any discounts. Pricing is outcome-based — each request is charged for the work performed and the content delivered, whether the effort was set automatically (`auto`) or pinned with a fixed mode.","uniqueKey":"metrics.cost_dollars","typeLabel":"number"},"effort":{"type":"string","enum":["low","medium","high","max"],"description":"Resolved effort tier for this request — the tier `auto` mode selected, or the one pinned via `searchMode`/`effort`.","uniqueKey":"metrics.effort","typeLabel":"enum\u003cstring>"},"response_time_ms":{"type":"integer","description":"Total server response time in milliseconds.","uniqueKey":"metrics.response_time_ms","typeLabel":"integer"},"search_mode":{"type":"string","description":"The mode the search ran in. With `auto`, the mode Andi chose.","uniqueKey":"metrics.search_mode","typeLabel":"string"},"mode_reason":{"type":"string","description":"Why that mode ran: `requested`, `effort`, or with `auto` a short reason code such as `default_balanced`, `deep_intent` or `high_complexity`.","uniqueKey":"metrics.mode_reason","typeLabel":"string"},"mode_note":{"type":"string","description":"Present when the mode you set is below what the question looks like it needs. Absent with `auto` and on cached responses.","uniqueKey":"metrics.mode_note","typeLabel":"string"}},"isRequired":true,"uniqueKey":"metrics","typeLabel":"object"},"answer_metadata":{"type":"object","description":"How the answer was made. `kind` is `extractive`, `instant` or `llm`; `citations` are the links of the rows it came from; `passage` is where on the row a quote came from; `block` (instant answers) names the response field that holds the answer's data (such as `weather`, `calculation`, `time`, `currency`, `quote`, `score`). It points to that field and never copies it. `data` appears only for a value that exists nowhere else, such as an extracted value.","properties":{"kind":{"type":"string","enum":["extractive","instant","llm"],"uniqueKey":"answer_metadata.kind","typeLabel":"enum\u003cstring>"},"citations":{"type":"array","items":{"type":"string","uniqueKey":"answer_metadata.citations.items.[INDEX]","typeLabel":"string"},"uniqueKey":"answer_metadata.citations","typeLabel":"string[]"},"passage":{"type":"string","enum":["snippet","extract","page","desc","title"],"uniqueKey":"answer_metadata.passage","typeLabel":"enum\u003cstring>"},"basis":{"type":"string","enum":["title","passage","title+passage"],"description":"What carried the answer: the result's title, the passage, or the passage read with its title. Optional.","uniqueKey":"answer_metadata.basis","typeLabel":"enum\u003cstring>"},"asOf":{"type":"string","description":"The date the answer's page holds (the later of published and last-updated). Optional.","uniqueKey":"answer_metadata.asOf","typeLabel":"string"},"asOfSource":{"type":"string","enum":["modified","published"],"description":"Whether `asOf` is the page's last-updated or published date. Optional.","uniqueKey":"answer_metadata.asOfSource","typeLabel":"enum\u003cstring>"},"block":{"type":"string","description":"The response field that holds this answer's data.","uniqueKey":"answer_metadata.block","typeLabel":"string"},"confidence":{"type":"number","description":"Extracted answers: reliability score, 0 to 1. Combines whether the passage states the answer, reads cleanly, agrees with other sources, is up to date, and how well rated its source is. A passage reaches the top-level `answer` only at 0.7 or more with no failed check; otherwise it stays on its result row. Optional.","uniqueKey":"answer_metadata.confidence","typeLabel":"number"},"clean":{"type":"boolean","description":"Extracted answers: the passage reads as a clean, complete answer. Optional; absent when not known.","uniqueKey":"answer_metadata.clean","typeLabel":"boolean"},"consistent":{"type":"boolean","description":"Extracted answers: no other source gives a different answer. Optional; absent when not known.","uniqueKey":"answer_metadata.consistent","typeLabel":"boolean"},"volatile":{"type":"boolean","description":"Extracted answers: the answer changes over time (a price, count or current holder). Optional; absent when not known.","uniqueKey":"answer_metadata.volatile","typeLabel":"boolean"},"current":{"type":"boolean","description":"Extracted answers: the answer is up to date. Optional; absent when not known.","uniqueKey":"answer_metadata.current","typeLabel":"boolean"}},"uniqueKey":"answer_metadata","typeLabel":"object"},"correctedQuery":{"type":"string","description":"Spell-corrected query. Present when a misspelling in the original query is detected and corrected — any mode can return it; deep and exhaustive modes run the strongest spell correction.","uniqueKey":"correctedQuery","typeLabel":"string"},"related_searches":{"type":"array","description":"Related search suggestions. Present on some queries.","items":{"type":"string","uniqueKey":"related_searches.items.[INDEX]","typeLabel":"string"},"uniqueKey":"related_searches","typeLabel":"string[]"},"topics":{"type":"array","description":"Related topics. Present on some queries.","items":{"type":"string","uniqueKey":"topics.items.[INDEX]","typeLabel":"string"},"uniqueKey":"topics","typeLabel":"string[]"},"related_topics":{"type":"array","description":"Related topic names for entity answers.","items":{"type":"string","uniqueKey":"related_topics.items.[INDEX]","typeLabel":"string"},"uniqueKey":"related_topics","typeLabel":"string[]"},"infobox":{"type":"object","description":"Facts panel for an entity answer.","properties":{"heading":{"type":"string","uniqueKey":"infobox.heading","typeLabel":"string"},"source":{"type":"string","uniqueKey":"infobox.source","typeLabel":"string"},"items":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string","uniqueKey":"infobox.\\items.items.[INDEX].label","typeLabel":"string"},"value":{"type":"string","uniqueKey":"infobox.\\items.items.[INDEX].value","typeLabel":"string"}},"uniqueKey":"infobox.\\items.items.[INDEX]","typeLabel":"object"},"uniqueKey":"infobox.\\items","typeLabel":"object[]"}},"uniqueKey":"infobox","typeLabel":"object"},"aiSummary":{"type":"object","description":"A pre-written news summary. News feeds return it, and so does search when the query asks for a whole feed (for example \"latest technology news\" or \"hacker news\"), but not for a topic inside a feed (\"nfl news\"). On news feeds the same text is in `answer`; on search, `answer` can hold something else, such as a description of the site.","properties":{"text":{"type":"string","description":"The summary, as markdown.","uniqueKey":"aiSummary.text","typeLabel":"string"},"generatedAt":{"type":"string","format":"date-time","description":"When the summary was written.","uniqueKey":"aiSummary.generatedAt","typeLabel":"string\u003cdate-time>"},"model":{"type":"string","description":"A short label for the summary's source.","uniqueKey":"aiSummary.model","typeLabel":"string"},"mode":{"type":"string","enum":["pregen"],"description":"`pregen` means the summary was written ahead of your request.","uniqueKey":"aiSummary.mode","typeLabel":"enum\u003cstring>"}},"uniqueKey":"aiSummary","typeLabel":"object"},"filter_counts":{"type":"object","description":"Present when an `author` or `publisher` filter is set: how many shown results match it and how many have no known author or publisher.","properties":{"matched":{"type":"integer","uniqueKey":"filter_counts.matched","typeLabel":"integer"},"unknown":{"type":"integer","uniqueKey":"filter_counts.unknown","typeLabel":"integer"}},"uniqueKey":"filter_counts","typeLabel":"object"},"locale":{"type":"object","description":"The language and country Andi searched for. Present on every search response (not on news feeds). With `format=context`, the same values appear in the frontmatter as `language`, `language_confidence`, `language_source`, `country` and `local_scope`.","properties":{"language":{"type":"string","description":"ISO 639-1 code of the query language, or `und` when unknown.","example":"de","isRequired":true,"uniqueKey":"locale.language","typeLabel":"string"},"languageConfidence":{"type":"number","minimum":0,"maximum":1,"description":"Confidence in `language`, from 0 to 1.","isRequired":true,"uniqueKey":"locale.languageConfidence","typeLabel":"number"},"languageSource":{"type":"string","enum":["param","detected","none"],"description":"Where `language` came from: `param` (you stated it), `detected` (Andi detected it from the query), or `none`.","isRequired":true,"uniqueKey":"locale.languageSource","typeLabel":"enum\u003cstring>"},"country":{"type":"string","description":"ISO 3166-1 country code the search was scoped to. Left out when unknown.","example":"DE","uniqueKey":"locale.country","typeLabel":"string"},"localScope":{"type":"string","enum":["global","country","city"],"description":"How much the answer depends on the searcher's place. Left out when not judged.","uniqueKey":"locale.localScope","typeLabel":"enum\u003cstring>"}},"required":["language","languageConfidence","languageSource"],"uniqueKey":"locale","typeLabel":"object"},"safeSearch":{"type":"object","description":"Echo of the safe-search state. Present on cache misses. Use it to confirm your `safe` parameter was honored.","properties":{"requested":{"type":"string","enum":["off","moderate","strict"],"uniqueKey":"safeSearch.requested","typeLabel":"enum\u003cstring>"},"applied":{"type":"string","enum":["off","moderate","strict"],"uniqueKey":"safeSearch.applied","typeLabel":"enum\u003cstring>"}},"uniqueKey":"safeSearch","typeLabel":"object"},"videos":{"type":"array","description":"Video results, when the search found any.","items":{"type":"object","properties":{"title":{"type":"string","description":"Page title.","isRequired":true,"uniqueKey":"videos.items.[INDEX].title","typeLabel":"string"},"link":{"type":"string","format":"uri","description":"Page URL.","isRequired":true,"uniqueKey":"videos.items.[INDEX].link","typeLabel":"string\u003curi>"},"desc":{"type":"string","description":"Page description or summary.","isRequired":true,"uniqueKey":"videos.items.[INDEX].desc","typeLabel":"string"},"source":{"type":"string","description":"Site or publisher name (for example `Wikipedia`); a name derived from the domain when none is known.","isRequired":true,"uniqueKey":"videos.items.[INDEX].source","typeLabel":"string"},"type":{"type":"string","description":"Result type. Only included when `metadata=full`.","enum":["website","blog","news","video","image","place","profile","social","academic","calculation","weather","computation","instant answer"],"uniqueKey":"videos.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"date":{"type":"string","description":"Publication date of the content, when available.","uniqueKey":"videos.items.[INDEX].date","typeLabel":"string"},"dateModified":{"type":"string","description":"When the page was last updated, if known.","uniqueKey":"videos.items.[INDEX].dateModified","typeLabel":"string"},"image":{"type":"string","format":"uri","description":"Preview image URL, when available. Only included when `metadata=full`.","uniqueKey":"videos.items.[INDEX].image","typeLabel":"string\u003curi>"},"snippet":{"type":"string","description":"Query-relevant text excerpt from the page. Distinct from `desc`, which is the general page description.","uniqueKey":"videos.items.[INDEX].snippet","typeLabel":"string"},"answer":{"type":"string","description":"Inline answer for instant answer results.","uniqueKey":"videos.items.[INDEX].answer","typeLabel":"string"},"extracts":{"type":"array","items":{"type":"string","uniqueKey":"videos.items.[INDEX].extracts.items.[INDEX]","typeLabel":"string"},"description":"Query-relevant passages from the page. Returned with `extracts=true`, and by default with `format=context`, `content=true` and `metadata=full`.","uniqueKey":"videos.items.[INDEX].extracts","typeLabel":"string[]"},"contentType":{"type":"string","description":"Content type of the page. Only included when `metadata=full`.","uniqueKey":"videos.items.[INDEX].contentType","typeLabel":"string"},"reader":{"type":"object","description":"Extracted page content and metadata. Included with `metadata=full`; with `content=true` it holds the full page text in `reader.markdown` (or `reader.content`) at any metadata level.","uniqueKey":"videos.items.[INDEX].reader","typeLabel":"object"},"contentSafety":{"type":"object","description":"Safety classification. Only included when `metadata=full`.","properties":{"rating":{"type":"string","enum":["safe","unsafe","unknown"],"description":"Content safety rating.","uniqueKey":"videos.items.[INDEX].contentSafety.rating","typeLabel":"enum\u003cstring>"},"safeSearchApplied":{"type":"boolean","description":"Whether safe-search filtering was applied to this result.","uniqueKey":"videos.items.[INDEX].contentSafety.safeSearchApplied","typeLabel":"boolean"}},"uniqueKey":"videos.items.[INDEX].contentSafety","typeLabel":"object"},"bang":{"type":"string","description":"Bang shortcut for the result domain. Only included when `metadata=full`.","uniqueKey":"videos.items.[INDEX].bang","typeLabel":"string"},"queryIndices":{"type":"array","items":{"type":"integer","uniqueKey":"videos.items.[INDEX].queryIndices.items.[INDEX]","typeLabel":"integer"},"description":"Multi-query only: which of your queries (0-based) found this result.","uniqueKey":"videos.items.[INDEX].queryIndices","typeLabel":"integer[]"},"language":{"type":"string","description":"The page's language as a lower-case primary tag, for example `fr`. Left out when unknown.","uniqueKey":"videos.items.[INDEX].language","typeLabel":"string"},"site_country":{"type":"string","description":"ISO 3166-1 country code named by the site's country-code domain, for example `DE` for `.de`. Generic domains such as `.com` have none.","uniqueKey":"videos.items.[INDEX].site_country","typeLabel":"string"},"availability":{"type":"object","description":"Present only when something is wrong with the site or this page. `link` is never changed. Left out for healthy results.","properties":{"state":{"type":"string","enum":["redirected","parked","repurposed","hijacked","likely_dead","dead","gone"],"description":"`redirected`: the site has moved (see `movedTo`). `parked`: the domain is parked or for sale. `repurposed`: the domain now hosts unrelated content. `hijacked`: the domain was taken over. `likely_dead`: repeated checks over weeks failed. `dead`: the site is confirmed offline. `gone`: this one page was removed.","isRequired":true,"uniqueKey":"videos.items.[INDEX].availability.state","typeLabel":"enum\u003cstring>"},"scope":{"type":"string","enum":["site","page"],"description":"`site` when the whole site is affected, `page` when only this page is (`gone`).","isRequired":true,"uniqueKey":"videos.items.[INDEX].availability.scope","typeLabel":"enum\u003cstring>"},"source":{"type":"string","enum":["probe","rdap","origin","curated","page"],"description":"Who decided: Andi's own site checks (`probe`), the domain registry (`rdap`), the page's own server (`origin`), a curated list (`curated`), or the result's own title and snippet, which read as a parked or for-sale page (`page`).","isRequired":true,"uniqueKey":"videos.items.[INDEX].availability.source","typeLabel":"enum\u003cstring>"},"since":{"type":"string","format":"date-time","description":"When the state was first seen, when known.","uniqueKey":"videos.items.[INDEX].availability.since","typeLabel":"string\u003cdate-time>"},"checkedAt":{"type":"string","format":"date-time","description":"When the state was last checked, when known.","uniqueKey":"videos.items.[INDEX].availability.checkedAt","typeLabel":"string\u003cdate-time>"},"movedTo":{"type":"string","description":"Host the site moved to. Only with `state: redirected`.","uniqueKey":"videos.items.[INDEX].availability.movedTo","typeLabel":"string"}},"required":["state","scope","source"],"uniqueKey":"videos.items.[INDEX].availability","typeLabel":"object"},"archive":{"type":"array","description":"Saved copies of this exact page, newest first; the first entry is the best one. Present only on results that have `availability`.","items":{"type":"object","properties":{"source":{"type":"string","description":"Where the copy is kept: `wayback` (Internet Archive) or `andi` (Andi's own stored copy).","isRequired":true,"uniqueKey":"videos.items.[INDEX].archive.items.[INDEX].source","typeLabel":"string"},"url":{"oneOf":[{"type":"string","description":"Public address of the copy. `null` for Andi's own copy, which has no public address: read it with the fetch endpoint using the result's `link`.","isRequired":true,"uniqueKey":"videos.items.[INDEX].archive.items.[INDEX].url.oneOf.0","typeLabel":"string"},{"type":"null","description":"Public address of the copy. `null` for Andi's own copy, which has no public address: read it with the fetch endpoint using the result's `link`.","isRequired":true,"uniqueKey":"videos.items.[INDEX].archive.items.[INDEX].url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"videos.items.[INDEX].archive.items.[INDEX].url","typeLabel":"string | null"},"capturedAt":{"type":"string","format":"date-time","description":"When the copy was saved.","uniqueKey":"videos.items.[INDEX].archive.items.[INDEX].capturedAt","typeLabel":"string\u003cdate-time>"}},"required":["source","url"],"uniqueKey":"videos.items.[INDEX].archive.items.[INDEX]","typeLabel":"object"},"uniqueKey":"videos.items.[INDEX].archive","typeLabel":"object[]"},"seeAlso":{"type":"array","description":"News feeds only: other outlets covering the same story.","items":{"type":"object","properties":{"title":{"type":"string","uniqueKey":"videos.items.[INDEX].seeAlso.items.[INDEX].title","typeLabel":"string"},"url":{"type":"string","format":"uri","uniqueKey":"videos.items.[INDEX].seeAlso.items.[INDEX].url","typeLabel":"string\u003curi>"},"source":{"type":"string","uniqueKey":"videos.items.[INDEX].seeAlso.items.[INDEX].source","typeLabel":"string"}},"uniqueKey":"videos.items.[INDEX].seeAlso.items.[INDEX]","typeLabel":"object"},"uniqueKey":"videos.items.[INDEX].seeAlso","typeLabel":"object[]"},"truncated":{"type":"boolean","description":"`true` when the result shows less page text than the page holds (cut to fit `maxTokens`, or focused to the parts that answer the query). A result with only a snippet or extracts is marked only when the budget cut it. Fetch the page's URL for the rest.","uniqueKey":"videos.items.[INDEX].truncated","typeLabel":"boolean"},"shown_words":{"type":"integer","description":"Words of page text this result shows. Present with `truncated`.","uniqueKey":"videos.items.[INDEX].shown_words","typeLabel":"integer"},"total_words":{"type":"integer","description":"Words the whole page holds. Present with `truncated`.","uniqueKey":"videos.items.[INDEX].total_words","typeLabel":"integer"}},"required":["title","link","desc","source"],"uniqueKey":"videos.items.[INDEX]","typeLabel":"object"},"uniqueKey":"videos","typeLabel":"object[]"},"images":{"type":"array","description":"Image results, when the search found any.","items":{"type":"object","properties":{"title":{"type":"string","description":"Image title or alt text.","isRequired":true,"uniqueKey":"images.items.[INDEX].title","typeLabel":"string"},"link":{"type":"string","format":"uri","description":"URL of the page containing the image.","isRequired":true,"uniqueKey":"images.items.[INDEX].link","typeLabel":"string\u003curi>"},"image":{"type":"string","format":"uri","description":"Direct URL of the full-size image.","isRequired":true,"uniqueKey":"images.items.[INDEX].image","typeLabel":"string\u003curi>"},"source":{"type":"string","description":"Site or publisher name (for example `Wikipedia`); a name derived from the domain when none is known.","isRequired":true,"uniqueKey":"images.items.[INDEX].source","typeLabel":"string"},"type":{"type":"string","description":"Always `image`.","enum":["image"],"isRequired":true,"uniqueKey":"images.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"thumbnail":{"type":"string","format":"uri","description":"Thumbnail URL.","uniqueKey":"images.items.[INDEX].thumbnail","typeLabel":"string\u003curi>"},"width":{"type":"string","description":"Image width in pixels (as a string).","uniqueKey":"images.items.[INDEX].width","typeLabel":"string"},"height":{"type":"string","description":"Image height in pixels (as a string).","uniqueKey":"images.items.[INDEX].height","typeLabel":"string"}},"required":["title","link","image","source","type"],"uniqueKey":"images.items.[INDEX]","typeLabel":"object"},"uniqueKey":"images","typeLabel":"object[]"},"news":{"type":"array","description":"News stories, when the search found any. Front pages, section pages, topic pages and listing pages are in `categories`, not here.","items":{"type":"object","properties":{"title":{"type":"string","description":"Page title.","isRequired":true,"uniqueKey":"news.items.[INDEX].title","typeLabel":"string"},"link":{"type":"string","format":"uri","description":"Page URL.","isRequired":true,"uniqueKey":"news.items.[INDEX].link","typeLabel":"string\u003curi>"},"desc":{"type":"string","description":"Page description or summary.","isRequired":true,"uniqueKey":"news.items.[INDEX].desc","typeLabel":"string"},"source":{"type":"string","description":"Site or publisher name (for example `Wikipedia`); a name derived from the domain when none is known.","isRequired":true,"uniqueKey":"news.items.[INDEX].source","typeLabel":"string"},"type":{"type":"string","description":"Result type. Only included when `metadata=full`.","enum":["website","blog","news","video","image","place","profile","social","academic","calculation","weather","computation","instant answer"],"uniqueKey":"news.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"date":{"type":"string","description":"Publication date of the content, when available.","uniqueKey":"news.items.[INDEX].date","typeLabel":"string"},"dateModified":{"type":"string","description":"When the page was last updated, if known.","uniqueKey":"news.items.[INDEX].dateModified","typeLabel":"string"},"image":{"type":"string","format":"uri","description":"Preview image URL, when available. Only included when `metadata=full`.","uniqueKey":"news.items.[INDEX].image","typeLabel":"string\u003curi>"},"snippet":{"type":"string","description":"Query-relevant text excerpt from the page. Distinct from `desc`, which is the general page description.","uniqueKey":"news.items.[INDEX].snippet","typeLabel":"string"},"answer":{"type":"string","description":"Inline answer for instant answer results.","uniqueKey":"news.items.[INDEX].answer","typeLabel":"string"},"extracts":{"type":"array","items":{"type":"string","uniqueKey":"news.items.[INDEX].extracts.items.[INDEX]","typeLabel":"string"},"description":"Query-relevant passages from the page. Returned with `extracts=true`, and by default with `format=context`, `content=true` and `metadata=full`.","uniqueKey":"news.items.[INDEX].extracts","typeLabel":"string[]"},"contentType":{"type":"string","description":"Content type of the page. Only included when `metadata=full`.","uniqueKey":"news.items.[INDEX].contentType","typeLabel":"string"},"reader":{"type":"object","description":"Extracted page content and metadata. Included with `metadata=full`; with `content=true` it holds the full page text in `reader.markdown` (or `reader.content`) at any metadata level.","uniqueKey":"news.items.[INDEX].reader","typeLabel":"object"},"contentSafety":{"type":"object","description":"Safety classification. Only included when `metadata=full`.","properties":{"rating":{"type":"string","enum":["safe","unsafe","unknown"],"description":"Content safety rating.","uniqueKey":"news.items.[INDEX].contentSafety.rating","typeLabel":"enum\u003cstring>"},"safeSearchApplied":{"type":"boolean","description":"Whether safe-search filtering was applied to this result.","uniqueKey":"news.items.[INDEX].contentSafety.safeSearchApplied","typeLabel":"boolean"}},"uniqueKey":"news.items.[INDEX].contentSafety","typeLabel":"object"},"bang":{"type":"string","description":"Bang shortcut for the result domain. Only included when `metadata=full`.","uniqueKey":"news.items.[INDEX].bang","typeLabel":"string"},"queryIndices":{"type":"array","items":{"type":"integer","uniqueKey":"news.items.[INDEX].queryIndices.items.[INDEX]","typeLabel":"integer"},"description":"Multi-query only: which of your queries (0-based) found this result.","uniqueKey":"news.items.[INDEX].queryIndices","typeLabel":"integer[]"},"language":{"type":"string","description":"The page's language as a lower-case primary tag, for example `fr`. Left out when unknown.","uniqueKey":"news.items.[INDEX].language","typeLabel":"string"},"site_country":{"type":"string","description":"ISO 3166-1 country code named by the site's country-code domain, for example `DE` for `.de`. Generic domains such as `.com` have none.","uniqueKey":"news.items.[INDEX].site_country","typeLabel":"string"},"availability":{"type":"object","description":"Present only when something is wrong with the site or this page. `link` is never changed. Left out for healthy results.","properties":{"state":{"type":"string","enum":["redirected","parked","repurposed","hijacked","likely_dead","dead","gone"],"description":"`redirected`: the site has moved (see `movedTo`). `parked`: the domain is parked or for sale. `repurposed`: the domain now hosts unrelated content. `hijacked`: the domain was taken over. `likely_dead`: repeated checks over weeks failed. `dead`: the site is confirmed offline. `gone`: this one page was removed.","isRequired":true,"uniqueKey":"news.items.[INDEX].availability.state","typeLabel":"enum\u003cstring>"},"scope":{"type":"string","enum":["site","page"],"description":"`site` when the whole site is affected, `page` when only this page is (`gone`).","isRequired":true,"uniqueKey":"news.items.[INDEX].availability.scope","typeLabel":"enum\u003cstring>"},"source":{"type":"string","enum":["probe","rdap","origin","curated","page"],"description":"Who decided: Andi's own site checks (`probe`), the domain registry (`rdap`), the page's own server (`origin`), a curated list (`curated`), or the result's own title and snippet, which read as a parked or for-sale page (`page`).","isRequired":true,"uniqueKey":"news.items.[INDEX].availability.source","typeLabel":"enum\u003cstring>"},"since":{"type":"string","format":"date-time","description":"When the state was first seen, when known.","uniqueKey":"news.items.[INDEX].availability.since","typeLabel":"string\u003cdate-time>"},"checkedAt":{"type":"string","format":"date-time","description":"When the state was last checked, when known.","uniqueKey":"news.items.[INDEX].availability.checkedAt","typeLabel":"string\u003cdate-time>"},"movedTo":{"type":"string","description":"Host the site moved to. Only with `state: redirected`.","uniqueKey":"news.items.[INDEX].availability.movedTo","typeLabel":"string"}},"required":["state","scope","source"],"uniqueKey":"news.items.[INDEX].availability","typeLabel":"object"},"archive":{"type":"array","description":"Saved copies of this exact page, newest first; the first entry is the best one. Present only on results that have `availability`.","items":{"type":"object","properties":{"source":{"type":"string","description":"Where the copy is kept: `wayback` (Internet Archive) or `andi` (Andi's own stored copy).","isRequired":true,"uniqueKey":"news.items.[INDEX].archive.items.[INDEX].source","typeLabel":"string"},"url":{"oneOf":[{"type":"string","description":"Public address of the copy. `null` for Andi's own copy, which has no public address: read it with the fetch endpoint using the result's `link`.","isRequired":true,"uniqueKey":"news.items.[INDEX].archive.items.[INDEX].url.oneOf.0","typeLabel":"string"},{"type":"null","description":"Public address of the copy. `null` for Andi's own copy, which has no public address: read it with the fetch endpoint using the result's `link`.","isRequired":true,"uniqueKey":"news.items.[INDEX].archive.items.[INDEX].url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"news.items.[INDEX].archive.items.[INDEX].url","typeLabel":"string | null"},"capturedAt":{"type":"string","format":"date-time","description":"When the copy was saved.","uniqueKey":"news.items.[INDEX].archive.items.[INDEX].capturedAt","typeLabel":"string\u003cdate-time>"}},"required":["source","url"],"uniqueKey":"news.items.[INDEX].archive.items.[INDEX]","typeLabel":"object"},"uniqueKey":"news.items.[INDEX].archive","typeLabel":"object[]"},"seeAlso":{"type":"array","description":"News feeds only: other outlets covering the same story.","items":{"type":"object","properties":{"title":{"type":"string","uniqueKey":"news.items.[INDEX].seeAlso.items.[INDEX].title","typeLabel":"string"},"url":{"type":"string","format":"uri","uniqueKey":"news.items.[INDEX].seeAlso.items.[INDEX].url","typeLabel":"string\u003curi>"},"source":{"type":"string","uniqueKey":"news.items.[INDEX].seeAlso.items.[INDEX].source","typeLabel":"string"}},"uniqueKey":"news.items.[INDEX].seeAlso.items.[INDEX]","typeLabel":"object"},"uniqueKey":"news.items.[INDEX].seeAlso","typeLabel":"object[]"},"truncated":{"type":"boolean","description":"`true` when the result shows less page text than the page holds (cut to fit `maxTokens`, or focused to the parts that answer the query). A result with only a snippet or extracts is marked only when the budget cut it. Fetch the page's URL for the rest.","uniqueKey":"news.items.[INDEX].truncated","typeLabel":"boolean"},"shown_words":{"type":"integer","description":"Words of page text this result shows. Present with `truncated`.","uniqueKey":"news.items.[INDEX].shown_words","typeLabel":"integer"},"total_words":{"type":"integer","description":"Words the whole page holds. Present with `truncated`.","uniqueKey":"news.items.[INDEX].total_words","typeLabel":"integer"}},"required":["title","link","desc","source"],"uniqueKey":"news.items.[INDEX]","typeLabel":"object"},"uniqueKey":"news","typeLabel":"object[]"},"citations":{"type":"array","description":"Rows an answer cites, in the same shape as `results`. When a search names a whole curated news feed (for example \"headlines\" or \"latest news from hacker news\") and the response carries the feed's `aiSummary`, this lists the stories the summary cites in the summary's order, then the feed's other stories, up to `limit`. Left out when empty. Not on `/api/v1/news`.","items":{"type":"object","properties":{"title":{"type":"string","description":"Page title.","isRequired":true,"uniqueKey":"citations.items.[INDEX].title","typeLabel":"string"},"link":{"type":"string","format":"uri","description":"Page URL.","isRequired":true,"uniqueKey":"citations.items.[INDEX].link","typeLabel":"string\u003curi>"},"desc":{"type":"string","description":"Page description or summary.","isRequired":true,"uniqueKey":"citations.items.[INDEX].desc","typeLabel":"string"},"source":{"type":"string","description":"Site or publisher name (for example `Wikipedia`); a name derived from the domain when none is known.","isRequired":true,"uniqueKey":"citations.items.[INDEX].source","typeLabel":"string"},"type":{"type":"string","description":"Result type. Only included when `metadata=full`.","enum":["website","blog","news","video","image","place","profile","social","academic","calculation","weather","computation","instant answer"],"uniqueKey":"citations.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"date":{"type":"string","description":"Publication date of the content, when available.","uniqueKey":"citations.items.[INDEX].date","typeLabel":"string"},"dateModified":{"type":"string","description":"When the page was last updated, if known.","uniqueKey":"citations.items.[INDEX].dateModified","typeLabel":"string"},"image":{"type":"string","format":"uri","description":"Preview image URL, when available. Only included when `metadata=full`.","uniqueKey":"citations.items.[INDEX].image","typeLabel":"string\u003curi>"},"snippet":{"type":"string","description":"Query-relevant text excerpt from the page. Distinct from `desc`, which is the general page description.","uniqueKey":"citations.items.[INDEX].snippet","typeLabel":"string"},"answer":{"type":"string","description":"Inline answer for instant answer results.","uniqueKey":"citations.items.[INDEX].answer","typeLabel":"string"},"extracts":{"type":"array","items":{"type":"string","uniqueKey":"citations.items.[INDEX].extracts.items.[INDEX]","typeLabel":"string"},"description":"Query-relevant passages from the page. Returned with `extracts=true`, and by default with `format=context`, `content=true` and `metadata=full`.","uniqueKey":"citations.items.[INDEX].extracts","typeLabel":"string[]"},"contentType":{"type":"string","description":"Content type of the page. Only included when `metadata=full`.","uniqueKey":"citations.items.[INDEX].contentType","typeLabel":"string"},"reader":{"type":"object","description":"Extracted page content and metadata. Included with `metadata=full`; with `content=true` it holds the full page text in `reader.markdown` (or `reader.content`) at any metadata level.","uniqueKey":"citations.items.[INDEX].reader","typeLabel":"object"},"contentSafety":{"type":"object","description":"Safety classification. Only included when `metadata=full`.","properties":{"rating":{"type":"string","enum":["safe","unsafe","unknown"],"description":"Content safety rating.","uniqueKey":"citations.items.[INDEX].contentSafety.rating","typeLabel":"enum\u003cstring>"},"safeSearchApplied":{"type":"boolean","description":"Whether safe-search filtering was applied to this result.","uniqueKey":"citations.items.[INDEX].contentSafety.safeSearchApplied","typeLabel":"boolean"}},"uniqueKey":"citations.items.[INDEX].contentSafety","typeLabel":"object"},"bang":{"type":"string","description":"Bang shortcut for the result domain. Only included when `metadata=full`.","uniqueKey":"citations.items.[INDEX].bang","typeLabel":"string"},"queryIndices":{"type":"array","items":{"type":"integer","uniqueKey":"citations.items.[INDEX].queryIndices.items.[INDEX]","typeLabel":"integer"},"description":"Multi-query only: which of your queries (0-based) found this result.","uniqueKey":"citations.items.[INDEX].queryIndices","typeLabel":"integer[]"},"language":{"type":"string","description":"The page's language as a lower-case primary tag, for example `fr`. Left out when unknown.","uniqueKey":"citations.items.[INDEX].language","typeLabel":"string"},"site_country":{"type":"string","description":"ISO 3166-1 country code named by the site's country-code domain, for example `DE` for `.de`. Generic domains such as `.com` have none.","uniqueKey":"citations.items.[INDEX].site_country","typeLabel":"string"},"availability":{"type":"object","description":"Present only when something is wrong with the site or this page. `link` is never changed. Left out for healthy results.","properties":{"state":{"type":"string","enum":["redirected","parked","repurposed","hijacked","likely_dead","dead","gone"],"description":"`redirected`: the site has moved (see `movedTo`). `parked`: the domain is parked or for sale. `repurposed`: the domain now hosts unrelated content. `hijacked`: the domain was taken over. `likely_dead`: repeated checks over weeks failed. `dead`: the site is confirmed offline. `gone`: this one page was removed.","isRequired":true,"uniqueKey":"citations.items.[INDEX].availability.state","typeLabel":"enum\u003cstring>"},"scope":{"type":"string","enum":["site","page"],"description":"`site` when the whole site is affected, `page` when only this page is (`gone`).","isRequired":true,"uniqueKey":"citations.items.[INDEX].availability.scope","typeLabel":"enum\u003cstring>"},"source":{"type":"string","enum":["probe","rdap","origin","curated","page"],"description":"Who decided: Andi's own site checks (`probe`), the domain registry (`rdap`), the page's own server (`origin`), a curated list (`curated`), or the result's own title and snippet, which read as a parked or for-sale page (`page`).","isRequired":true,"uniqueKey":"citations.items.[INDEX].availability.source","typeLabel":"enum\u003cstring>"},"since":{"type":"string","format":"date-time","description":"When the state was first seen, when known.","uniqueKey":"citations.items.[INDEX].availability.since","typeLabel":"string\u003cdate-time>"},"checkedAt":{"type":"string","format":"date-time","description":"When the state was last checked, when known.","uniqueKey":"citations.items.[INDEX].availability.checkedAt","typeLabel":"string\u003cdate-time>"},"movedTo":{"type":"string","description":"Host the site moved to. Only with `state: redirected`.","uniqueKey":"citations.items.[INDEX].availability.movedTo","typeLabel":"string"}},"required":["state","scope","source"],"uniqueKey":"citations.items.[INDEX].availability","typeLabel":"object"},"archive":{"type":"array","description":"Saved copies of this exact page, newest first; the first entry is the best one. Present only on results that have `availability`.","items":{"type":"object","properties":{"source":{"type":"string","description":"Where the copy is kept: `wayback` (Internet Archive) or `andi` (Andi's own stored copy).","isRequired":true,"uniqueKey":"citations.items.[INDEX].archive.items.[INDEX].source","typeLabel":"string"},"url":{"oneOf":[{"type":"string","description":"Public address of the copy. `null` for Andi's own copy, which has no public address: read it with the fetch endpoint using the result's `link`.","isRequired":true,"uniqueKey":"citations.items.[INDEX].archive.items.[INDEX].url.oneOf.0","typeLabel":"string"},{"type":"null","description":"Public address of the copy. `null` for Andi's own copy, which has no public address: read it with the fetch endpoint using the result's `link`.","isRequired":true,"uniqueKey":"citations.items.[INDEX].archive.items.[INDEX].url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"citations.items.[INDEX].archive.items.[INDEX].url","typeLabel":"string | null"},"capturedAt":{"type":"string","format":"date-time","description":"When the copy was saved.","uniqueKey":"citations.items.[INDEX].archive.items.[INDEX].capturedAt","typeLabel":"string\u003cdate-time>"}},"required":["source","url"],"uniqueKey":"citations.items.[INDEX].archive.items.[INDEX]","typeLabel":"object"},"uniqueKey":"citations.items.[INDEX].archive","typeLabel":"object[]"},"seeAlso":{"type":"array","description":"News feeds only: other outlets covering the same story.","items":{"type":"object","properties":{"title":{"type":"string","uniqueKey":"citations.items.[INDEX].seeAlso.items.[INDEX].title","typeLabel":"string"},"url":{"type":"string","format":"uri","uniqueKey":"citations.items.[INDEX].seeAlso.items.[INDEX].url","typeLabel":"string\u003curi>"},"source":{"type":"string","uniqueKey":"citations.items.[INDEX].seeAlso.items.[INDEX].source","typeLabel":"string"}},"uniqueKey":"citations.items.[INDEX].seeAlso.items.[INDEX]","typeLabel":"object"},"uniqueKey":"citations.items.[INDEX].seeAlso","typeLabel":"object[]"},"truncated":{"type":"boolean","description":"`true` when the result shows less page text than the page holds (cut to fit `maxTokens`, or focused to the parts that answer the query). A result with only a snippet or extracts is marked only when the budget cut it. Fetch the page's URL for the rest.","uniqueKey":"citations.items.[INDEX].truncated","typeLabel":"boolean"},"shown_words":{"type":"integer","description":"Words of page text this result shows. Present with `truncated`.","uniqueKey":"citations.items.[INDEX].shown_words","typeLabel":"integer"},"total_words":{"type":"integer","description":"Words the whole page holds. Present with `truncated`.","uniqueKey":"citations.items.[INDEX].total_words","typeLabel":"integer"}},"required":["title","link","desc","source"],"uniqueKey":"citations.items.[INDEX]","typeLabel":"object"},"uniqueKey":"citations","typeLabel":"object[]"},"categories":{"type":"array","description":"News front pages, section pages, topic or tag pages, listing pages and site-search pages. `results` still holds them too. Left out when empty. Not on `/api/v1/news`.","items":{"type":"object","properties":{"title":{"type":"string","description":"Page title.","isRequired":true,"uniqueKey":"categories.items.[INDEX].title","typeLabel":"string"},"link":{"type":"string","format":"uri","description":"Page URL.","isRequired":true,"uniqueKey":"categories.items.[INDEX].link","typeLabel":"string\u003curi>"},"desc":{"type":"string","description":"Page description or summary.","isRequired":true,"uniqueKey":"categories.items.[INDEX].desc","typeLabel":"string"},"source":{"type":"string","description":"Site or publisher name (for example `Wikipedia`); a name derived from the domain when none is known.","isRequired":true,"uniqueKey":"categories.items.[INDEX].source","typeLabel":"string"},"type":{"type":"string","description":"Result type. Only included when `metadata=full`.","enum":["website","blog","news","video","image","place","profile","social","academic","calculation","weather","computation","instant answer"],"uniqueKey":"categories.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"date":{"type":"string","description":"Publication date of the content, when available.","uniqueKey":"categories.items.[INDEX].date","typeLabel":"string"},"dateModified":{"type":"string","description":"When the page was last updated, if known.","uniqueKey":"categories.items.[INDEX].dateModified","typeLabel":"string"},"image":{"type":"string","format":"uri","description":"Preview image URL, when available. Only included when `metadata=full`.","uniqueKey":"categories.items.[INDEX].image","typeLabel":"string\u003curi>"},"snippet":{"type":"string","description":"Query-relevant text excerpt from the page. Distinct from `desc`, which is the general page description.","uniqueKey":"categories.items.[INDEX].snippet","typeLabel":"string"},"answer":{"type":"string","description":"Inline answer for instant answer results.","uniqueKey":"categories.items.[INDEX].answer","typeLabel":"string"},"extracts":{"type":"array","items":{"type":"string","uniqueKey":"categories.items.[INDEX].extracts.items.[INDEX]","typeLabel":"string"},"description":"Query-relevant passages from the page. Returned with `extracts=true`, and by default with `format=context`, `content=true` and `metadata=full`.","uniqueKey":"categories.items.[INDEX].extracts","typeLabel":"string[]"},"contentType":{"type":"string","description":"Content type of the page. Only included when `metadata=full`.","uniqueKey":"categories.items.[INDEX].contentType","typeLabel":"string"},"reader":{"type":"object","description":"Extracted page content and metadata. Included with `metadata=full`; with `content=true` it holds the full page text in `reader.markdown` (or `reader.content`) at any metadata level.","uniqueKey":"categories.items.[INDEX].reader","typeLabel":"object"},"contentSafety":{"type":"object","description":"Safety classification. Only included when `metadata=full`.","properties":{"rating":{"type":"string","enum":["safe","unsafe","unknown"],"description":"Content safety rating.","uniqueKey":"categories.items.[INDEX].contentSafety.rating","typeLabel":"enum\u003cstring>"},"safeSearchApplied":{"type":"boolean","description":"Whether safe-search filtering was applied to this result.","uniqueKey":"categories.items.[INDEX].contentSafety.safeSearchApplied","typeLabel":"boolean"}},"uniqueKey":"categories.items.[INDEX].contentSafety","typeLabel":"object"},"bang":{"type":"string","description":"Bang shortcut for the result domain. Only included when `metadata=full`.","uniqueKey":"categories.items.[INDEX].bang","typeLabel":"string"},"queryIndices":{"type":"array","items":{"type":"integer","uniqueKey":"categories.items.[INDEX].queryIndices.items.[INDEX]","typeLabel":"integer"},"description":"Multi-query only: which of your queries (0-based) found this result.","uniqueKey":"categories.items.[INDEX].queryIndices","typeLabel":"integer[]"},"language":{"type":"string","description":"The page's language as a lower-case primary tag, for example `fr`. Left out when unknown.","uniqueKey":"categories.items.[INDEX].language","typeLabel":"string"},"site_country":{"type":"string","description":"ISO 3166-1 country code named by the site's country-code domain, for example `DE` for `.de`. Generic domains such as `.com` have none.","uniqueKey":"categories.items.[INDEX].site_country","typeLabel":"string"},"availability":{"type":"object","description":"Present only when something is wrong with the site or this page. `link` is never changed. Left out for healthy results.","properties":{"state":{"type":"string","enum":["redirected","parked","repurposed","hijacked","likely_dead","dead","gone"],"description":"`redirected`: the site has moved (see `movedTo`). `parked`: the domain is parked or for sale. `repurposed`: the domain now hosts unrelated content. `hijacked`: the domain was taken over. `likely_dead`: repeated checks over weeks failed. `dead`: the site is confirmed offline. `gone`: this one page was removed.","isRequired":true,"uniqueKey":"categories.items.[INDEX].availability.state","typeLabel":"enum\u003cstring>"},"scope":{"type":"string","enum":["site","page"],"description":"`site` when the whole site is affected, `page` when only this page is (`gone`).","isRequired":true,"uniqueKey":"categories.items.[INDEX].availability.scope","typeLabel":"enum\u003cstring>"},"source":{"type":"string","enum":["probe","rdap","origin","curated","page"],"description":"Who decided: Andi's own site checks (`probe`), the domain registry (`rdap`), the page's own server (`origin`), a curated list (`curated`), or the result's own title and snippet, which read as a parked or for-sale page (`page`).","isRequired":true,"uniqueKey":"categories.items.[INDEX].availability.source","typeLabel":"enum\u003cstring>"},"since":{"type":"string","format":"date-time","description":"When the state was first seen, when known.","uniqueKey":"categories.items.[INDEX].availability.since","typeLabel":"string\u003cdate-time>"},"checkedAt":{"type":"string","format":"date-time","description":"When the state was last checked, when known.","uniqueKey":"categories.items.[INDEX].availability.checkedAt","typeLabel":"string\u003cdate-time>"},"movedTo":{"type":"string","description":"Host the site moved to. Only with `state: redirected`.","uniqueKey":"categories.items.[INDEX].availability.movedTo","typeLabel":"string"}},"required":["state","scope","source"],"uniqueKey":"categories.items.[INDEX].availability","typeLabel":"object"},"archive":{"type":"array","description":"Saved copies of this exact page, newest first; the first entry is the best one. Present only on results that have `availability`.","items":{"type":"object","properties":{"source":{"type":"string","description":"Where the copy is kept: `wayback` (Internet Archive) or `andi` (Andi's own stored copy).","isRequired":true,"uniqueKey":"categories.items.[INDEX].archive.items.[INDEX].source","typeLabel":"string"},"url":{"oneOf":[{"type":"string","description":"Public address of the copy. `null` for Andi's own copy, which has no public address: read it with the fetch endpoint using the result's `link`.","isRequired":true,"uniqueKey":"categories.items.[INDEX].archive.items.[INDEX].url.oneOf.0","typeLabel":"string"},{"type":"null","description":"Public address of the copy. `null` for Andi's own copy, which has no public address: read it with the fetch endpoint using the result's `link`.","isRequired":true,"uniqueKey":"categories.items.[INDEX].archive.items.[INDEX].url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"categories.items.[INDEX].archive.items.[INDEX].url","typeLabel":"string | null"},"capturedAt":{"type":"string","format":"date-time","description":"When the copy was saved.","uniqueKey":"categories.items.[INDEX].archive.items.[INDEX].capturedAt","typeLabel":"string\u003cdate-time>"}},"required":["source","url"],"uniqueKey":"categories.items.[INDEX].archive.items.[INDEX]","typeLabel":"object"},"uniqueKey":"categories.items.[INDEX].archive","typeLabel":"object[]"},"seeAlso":{"type":"array","description":"News feeds only: other outlets covering the same story.","items":{"type":"object","properties":{"title":{"type":"string","uniqueKey":"categories.items.[INDEX].seeAlso.items.[INDEX].title","typeLabel":"string"},"url":{"type":"string","format":"uri","uniqueKey":"categories.items.[INDEX].seeAlso.items.[INDEX].url","typeLabel":"string\u003curi>"},"source":{"type":"string","uniqueKey":"categories.items.[INDEX].seeAlso.items.[INDEX].source","typeLabel":"string"}},"uniqueKey":"categories.items.[INDEX].seeAlso.items.[INDEX]","typeLabel":"object"},"uniqueKey":"categories.items.[INDEX].seeAlso","typeLabel":"object[]"},"truncated":{"type":"boolean","description":"`true` when the result shows less page text than the page holds (cut to fit `maxTokens`, or focused to the parts that answer the query). A result with only a snippet or extracts is marked only when the budget cut it. Fetch the page's URL for the rest.","uniqueKey":"categories.items.[INDEX].truncated","typeLabel":"boolean"},"shown_words":{"type":"integer","description":"Words of page text this result shows. Present with `truncated`.","uniqueKey":"categories.items.[INDEX].shown_words","typeLabel":"integer"},"total_words":{"type":"integer","description":"Words the whole page holds. Present with `truncated`.","uniqueKey":"categories.items.[INDEX].total_words","typeLabel":"integer"}},"required":["title","link","desc","source"],"uniqueKey":"categories.items.[INDEX]","typeLabel":"object"},"uniqueKey":"categories","typeLabel":"object[]"},"places":{"type":"array","description":"Place and business results, when the search found any.","items":{"type":"object","properties":{"title":{"type":"string","description":"Page title.","isRequired":true,"uniqueKey":"places.items.[INDEX].title","typeLabel":"string"},"link":{"type":"string","format":"uri","description":"Page URL.","isRequired":true,"uniqueKey":"places.items.[INDEX].link","typeLabel":"string\u003curi>"},"desc":{"type":"string","description":"Page description or summary.","isRequired":true,"uniqueKey":"places.items.[INDEX].desc","typeLabel":"string"},"source":{"type":"string","description":"Site or publisher name (for example `Wikipedia`); a name derived from the domain when none is known.","isRequired":true,"uniqueKey":"places.items.[INDEX].source","typeLabel":"string"},"type":{"type":"string","description":"Result type. Only included when `metadata=full`.","enum":["website","blog","news","video","image","place","profile","social","academic","calculation","weather","computation","instant answer"],"uniqueKey":"places.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"date":{"type":"string","description":"Publication date of the content, when available.","uniqueKey":"places.items.[INDEX].date","typeLabel":"string"},"dateModified":{"type":"string","description":"When the page was last updated, if known.","uniqueKey":"places.items.[INDEX].dateModified","typeLabel":"string"},"image":{"type":"string","format":"uri","description":"Preview image URL, when available. Only included when `metadata=full`.","uniqueKey":"places.items.[INDEX].image","typeLabel":"string\u003curi>"},"snippet":{"type":"string","description":"Query-relevant text excerpt from the page. Distinct from `desc`, which is the general page description.","uniqueKey":"places.items.[INDEX].snippet","typeLabel":"string"},"answer":{"type":"string","description":"Inline answer for instant answer results.","uniqueKey":"places.items.[INDEX].answer","typeLabel":"string"},"extracts":{"type":"array","items":{"type":"string","uniqueKey":"places.items.[INDEX].extracts.items.[INDEX]","typeLabel":"string"},"description":"Query-relevant passages from the page. Returned with `extracts=true`, and by default with `format=context`, `content=true` and `metadata=full`.","uniqueKey":"places.items.[INDEX].extracts","typeLabel":"string[]"},"contentType":{"type":"string","description":"Content type of the page. Only included when `metadata=full`.","uniqueKey":"places.items.[INDEX].contentType","typeLabel":"string"},"reader":{"type":"object","description":"Extracted page content and metadata. Included with `metadata=full`; with `content=true` it holds the full page text in `reader.markdown` (or `reader.content`) at any metadata level.","uniqueKey":"places.items.[INDEX].reader","typeLabel":"object"},"contentSafety":{"type":"object","description":"Safety classification. Only included when `metadata=full`.","properties":{"rating":{"type":"string","enum":["safe","unsafe","unknown"],"description":"Content safety rating.","uniqueKey":"places.items.[INDEX].contentSafety.rating","typeLabel":"enum\u003cstring>"},"safeSearchApplied":{"type":"boolean","description":"Whether safe-search filtering was applied to this result.","uniqueKey":"places.items.[INDEX].contentSafety.safeSearchApplied","typeLabel":"boolean"}},"uniqueKey":"places.items.[INDEX].contentSafety","typeLabel":"object"},"bang":{"type":"string","description":"Bang shortcut for the result domain. Only included when `metadata=full`.","uniqueKey":"places.items.[INDEX].bang","typeLabel":"string"},"queryIndices":{"type":"array","items":{"type":"integer","uniqueKey":"places.items.[INDEX].queryIndices.items.[INDEX]","typeLabel":"integer"},"description":"Multi-query only: which of your queries (0-based) found this result.","uniqueKey":"places.items.[INDEX].queryIndices","typeLabel":"integer[]"},"language":{"type":"string","description":"The page's language as a lower-case primary tag, for example `fr`. Left out when unknown.","uniqueKey":"places.items.[INDEX].language","typeLabel":"string"},"site_country":{"type":"string","description":"ISO 3166-1 country code named by the site's country-code domain, for example `DE` for `.de`. Generic domains such as `.com` have none.","uniqueKey":"places.items.[INDEX].site_country","typeLabel":"string"},"availability":{"type":"object","description":"Present only when something is wrong with the site or this page. `link` is never changed. Left out for healthy results.","properties":{"state":{"type":"string","enum":["redirected","parked","repurposed","hijacked","likely_dead","dead","gone"],"description":"`redirected`: the site has moved (see `movedTo`). `parked`: the domain is parked or for sale. `repurposed`: the domain now hosts unrelated content. `hijacked`: the domain was taken over. `likely_dead`: repeated checks over weeks failed. `dead`: the site is confirmed offline. `gone`: this one page was removed.","isRequired":true,"uniqueKey":"places.items.[INDEX].availability.state","typeLabel":"enum\u003cstring>"},"scope":{"type":"string","enum":["site","page"],"description":"`site` when the whole site is affected, `page` when only this page is (`gone`).","isRequired":true,"uniqueKey":"places.items.[INDEX].availability.scope","typeLabel":"enum\u003cstring>"},"source":{"type":"string","enum":["probe","rdap","origin","curated","page"],"description":"Who decided: Andi's own site checks (`probe`), the domain registry (`rdap`), the page's own server (`origin`), a curated list (`curated`), or the result's own title and snippet, which read as a parked or for-sale page (`page`).","isRequired":true,"uniqueKey":"places.items.[INDEX].availability.source","typeLabel":"enum\u003cstring>"},"since":{"type":"string","format":"date-time","description":"When the state was first seen, when known.","uniqueKey":"places.items.[INDEX].availability.since","typeLabel":"string\u003cdate-time>"},"checkedAt":{"type":"string","format":"date-time","description":"When the state was last checked, when known.","uniqueKey":"places.items.[INDEX].availability.checkedAt","typeLabel":"string\u003cdate-time>"},"movedTo":{"type":"string","description":"Host the site moved to. Only with `state: redirected`.","uniqueKey":"places.items.[INDEX].availability.movedTo","typeLabel":"string"}},"required":["state","scope","source"],"uniqueKey":"places.items.[INDEX].availability","typeLabel":"object"},"archive":{"type":"array","description":"Saved copies of this exact page, newest first; the first entry is the best one. Present only on results that have `availability`.","items":{"type":"object","properties":{"source":{"type":"string","description":"Where the copy is kept: `wayback` (Internet Archive) or `andi` (Andi's own stored copy).","isRequired":true,"uniqueKey":"places.items.[INDEX].archive.items.[INDEX].source","typeLabel":"string"},"url":{"oneOf":[{"type":"string","description":"Public address of the copy. `null` for Andi's own copy, which has no public address: read it with the fetch endpoint using the result's `link`.","isRequired":true,"uniqueKey":"places.items.[INDEX].archive.items.[INDEX].url.oneOf.0","typeLabel":"string"},{"type":"null","description":"Public address of the copy. `null` for Andi's own copy, which has no public address: read it with the fetch endpoint using the result's `link`.","isRequired":true,"uniqueKey":"places.items.[INDEX].archive.items.[INDEX].url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"places.items.[INDEX].archive.items.[INDEX].url","typeLabel":"string | null"},"capturedAt":{"type":"string","format":"date-time","description":"When the copy was saved.","uniqueKey":"places.items.[INDEX].archive.items.[INDEX].capturedAt","typeLabel":"string\u003cdate-time>"}},"required":["source","url"],"uniqueKey":"places.items.[INDEX].archive.items.[INDEX]","typeLabel":"object"},"uniqueKey":"places.items.[INDEX].archive","typeLabel":"object[]"},"seeAlso":{"type":"array","description":"News feeds only: other outlets covering the same story.","items":{"type":"object","properties":{"title":{"type":"string","uniqueKey":"places.items.[INDEX].seeAlso.items.[INDEX].title","typeLabel":"string"},"url":{"type":"string","format":"uri","uniqueKey":"places.items.[INDEX].seeAlso.items.[INDEX].url","typeLabel":"string\u003curi>"},"source":{"type":"string","uniqueKey":"places.items.[INDEX].seeAlso.items.[INDEX].source","typeLabel":"string"}},"uniqueKey":"places.items.[INDEX].seeAlso.items.[INDEX]","typeLabel":"object"},"uniqueKey":"places.items.[INDEX].seeAlso","typeLabel":"object[]"},"truncated":{"type":"boolean","description":"`true` when the result shows less page text than the page holds (cut to fit `maxTokens`, or focused to the parts that answer the query). A result with only a snippet or extracts is marked only when the budget cut it. Fetch the page's URL for the rest.","uniqueKey":"places.items.[INDEX].truncated","typeLabel":"boolean"},"shown_words":{"type":"integer","description":"Words of page text this result shows. Present with `truncated`.","uniqueKey":"places.items.[INDEX].shown_words","typeLabel":"integer"},"total_words":{"type":"integer","description":"Words the whole page holds. Present with `truncated`.","uniqueKey":"places.items.[INDEX].total_words","typeLabel":"integer"}},"required":["title","link","desc","source"],"uniqueKey":"places.items.[INDEX]","typeLabel":"object"},"uniqueKey":"places","typeLabel":"object[]"},"profiles":{"type":"array","description":"People and entity profiles, when the search found any.","items":{"type":"object","properties":{"title":{"type":"string","description":"Page title.","isRequired":true,"uniqueKey":"profiles.items.[INDEX].title","typeLabel":"string"},"link":{"type":"string","format":"uri","description":"Page URL.","isRequired":true,"uniqueKey":"profiles.items.[INDEX].link","typeLabel":"string\u003curi>"},"desc":{"type":"string","description":"Page description or summary.","isRequired":true,"uniqueKey":"profiles.items.[INDEX].desc","typeLabel":"string"},"source":{"type":"string","description":"Site or publisher name (for example `Wikipedia`); a name derived from the domain when none is known.","isRequired":true,"uniqueKey":"profiles.items.[INDEX].source","typeLabel":"string"},"type":{"type":"string","description":"Result type. Only included when `metadata=full`.","enum":["website","blog","news","video","image","place","profile","social","academic","calculation","weather","computation","instant answer"],"uniqueKey":"profiles.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"date":{"type":"string","description":"Publication date of the content, when available.","uniqueKey":"profiles.items.[INDEX].date","typeLabel":"string"},"dateModified":{"type":"string","description":"When the page was last updated, if known.","uniqueKey":"profiles.items.[INDEX].dateModified","typeLabel":"string"},"image":{"type":"string","format":"uri","description":"Preview image URL, when available. Only included when `metadata=full`.","uniqueKey":"profiles.items.[INDEX].image","typeLabel":"string\u003curi>"},"snippet":{"type":"string","description":"Query-relevant text excerpt from the page. Distinct from `desc`, which is the general page description.","uniqueKey":"profiles.items.[INDEX].snippet","typeLabel":"string"},"answer":{"type":"string","description":"Inline answer for instant answer results.","uniqueKey":"profiles.items.[INDEX].answer","typeLabel":"string"},"extracts":{"type":"array","items":{"type":"string","uniqueKey":"profiles.items.[INDEX].extracts.items.[INDEX]","typeLabel":"string"},"description":"Query-relevant passages from the page. Returned with `extracts=true`, and by default with `format=context`, `content=true` and `metadata=full`.","uniqueKey":"profiles.items.[INDEX].extracts","typeLabel":"string[]"},"contentType":{"type":"string","description":"Content type of the page. Only included when `metadata=full`.","uniqueKey":"profiles.items.[INDEX].contentType","typeLabel":"string"},"reader":{"type":"object","description":"Extracted page content and metadata. Included with `metadata=full`; with `content=true` it holds the full page text in `reader.markdown` (or `reader.content`) at any metadata level.","uniqueKey":"profiles.items.[INDEX].reader","typeLabel":"object"},"contentSafety":{"type":"object","description":"Safety classification. Only included when `metadata=full`.","properties":{"rating":{"type":"string","enum":["safe","unsafe","unknown"],"description":"Content safety rating.","uniqueKey":"profiles.items.[INDEX].contentSafety.rating","typeLabel":"enum\u003cstring>"},"safeSearchApplied":{"type":"boolean","description":"Whether safe-search filtering was applied to this result.","uniqueKey":"profiles.items.[INDEX].contentSafety.safeSearchApplied","typeLabel":"boolean"}},"uniqueKey":"profiles.items.[INDEX].contentSafety","typeLabel":"object"},"bang":{"type":"string","description":"Bang shortcut for the result domain. Only included when `metadata=full`.","uniqueKey":"profiles.items.[INDEX].bang","typeLabel":"string"},"queryIndices":{"type":"array","items":{"type":"integer","uniqueKey":"profiles.items.[INDEX].queryIndices.items.[INDEX]","typeLabel":"integer"},"description":"Multi-query only: which of your queries (0-based) found this result.","uniqueKey":"profiles.items.[INDEX].queryIndices","typeLabel":"integer[]"},"language":{"type":"string","description":"The page's language as a lower-case primary tag, for example `fr`. Left out when unknown.","uniqueKey":"profiles.items.[INDEX].language","typeLabel":"string"},"site_country":{"type":"string","description":"ISO 3166-1 country code named by the site's country-code domain, for example `DE` for `.de`. Generic domains such as `.com` have none.","uniqueKey":"profiles.items.[INDEX].site_country","typeLabel":"string"},"availability":{"type":"object","description":"Present only when something is wrong with the site or this page. `link` is never changed. Left out for healthy results.","properties":{"state":{"type":"string","enum":["redirected","parked","repurposed","hijacked","likely_dead","dead","gone"],"description":"`redirected`: the site has moved (see `movedTo`). `parked`: the domain is parked or for sale. `repurposed`: the domain now hosts unrelated content. `hijacked`: the domain was taken over. `likely_dead`: repeated checks over weeks failed. `dead`: the site is confirmed offline. `gone`: this one page was removed.","isRequired":true,"uniqueKey":"profiles.items.[INDEX].availability.state","typeLabel":"enum\u003cstring>"},"scope":{"type":"string","enum":["site","page"],"description":"`site` when the whole site is affected, `page` when only this page is (`gone`).","isRequired":true,"uniqueKey":"profiles.items.[INDEX].availability.scope","typeLabel":"enum\u003cstring>"},"source":{"type":"string","enum":["probe","rdap","origin","curated","page"],"description":"Who decided: Andi's own site checks (`probe`), the domain registry (`rdap`), the page's own server (`origin`), a curated list (`curated`), or the result's own title and snippet, which read as a parked or for-sale page (`page`).","isRequired":true,"uniqueKey":"profiles.items.[INDEX].availability.source","typeLabel":"enum\u003cstring>"},"since":{"type":"string","format":"date-time","description":"When the state was first seen, when known.","uniqueKey":"profiles.items.[INDEX].availability.since","typeLabel":"string\u003cdate-time>"},"checkedAt":{"type":"string","format":"date-time","description":"When the state was last checked, when known.","uniqueKey":"profiles.items.[INDEX].availability.checkedAt","typeLabel":"string\u003cdate-time>"},"movedTo":{"type":"string","description":"Host the site moved to. Only with `state: redirected`.","uniqueKey":"profiles.items.[INDEX].availability.movedTo","typeLabel":"string"}},"required":["state","scope","source"],"uniqueKey":"profiles.items.[INDEX].availability","typeLabel":"object"},"archive":{"type":"array","description":"Saved copies of this exact page, newest first; the first entry is the best one. Present only on results that have `availability`.","items":{"type":"object","properties":{"source":{"type":"string","description":"Where the copy is kept: `wayback` (Internet Archive) or `andi` (Andi's own stored copy).","isRequired":true,"uniqueKey":"profiles.items.[INDEX].archive.items.[INDEX].source","typeLabel":"string"},"url":{"oneOf":[{"type":"string","description":"Public address of the copy. `null` for Andi's own copy, which has no public address: read it with the fetch endpoint using the result's `link`.","isRequired":true,"uniqueKey":"profiles.items.[INDEX].archive.items.[INDEX].url.oneOf.0","typeLabel":"string"},{"type":"null","description":"Public address of the copy. `null` for Andi's own copy, which has no public address: read it with the fetch endpoint using the result's `link`.","isRequired":true,"uniqueKey":"profiles.items.[INDEX].archive.items.[INDEX].url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"profiles.items.[INDEX].archive.items.[INDEX].url","typeLabel":"string | null"},"capturedAt":{"type":"string","format":"date-time","description":"When the copy was saved.","uniqueKey":"profiles.items.[INDEX].archive.items.[INDEX].capturedAt","typeLabel":"string\u003cdate-time>"}},"required":["source","url"],"uniqueKey":"profiles.items.[INDEX].archive.items.[INDEX]","typeLabel":"object"},"uniqueKey":"profiles.items.[INDEX].archive","typeLabel":"object[]"},"seeAlso":{"type":"array","description":"News feeds only: other outlets covering the same story.","items":{"type":"object","properties":{"title":{"type":"string","uniqueKey":"profiles.items.[INDEX].seeAlso.items.[INDEX].title","typeLabel":"string"},"url":{"type":"string","format":"uri","uniqueKey":"profiles.items.[INDEX].seeAlso.items.[INDEX].url","typeLabel":"string\u003curi>"},"source":{"type":"string","uniqueKey":"profiles.items.[INDEX].seeAlso.items.[INDEX].source","typeLabel":"string"}},"uniqueKey":"profiles.items.[INDEX].seeAlso.items.[INDEX]","typeLabel":"object"},"uniqueKey":"profiles.items.[INDEX].seeAlso","typeLabel":"object[]"},"truncated":{"type":"boolean","description":"`true` when the result shows less page text than the page holds (cut to fit `maxTokens`, or focused to the parts that answer the query). A result with only a snippet or extracts is marked only when the budget cut it. Fetch the page's URL for the rest.","uniqueKey":"profiles.items.[INDEX].truncated","typeLabel":"boolean"},"shown_words":{"type":"integer","description":"Words of page text this result shows. Present with `truncated`.","uniqueKey":"profiles.items.[INDEX].shown_words","typeLabel":"integer"},"total_words":{"type":"integer","description":"Words the whole page holds. Present with `truncated`.","uniqueKey":"profiles.items.[INDEX].total_words","typeLabel":"integer"}},"required":["title","link","desc","source"],"uniqueKey":"profiles.items.[INDEX]","typeLabel":"object"},"uniqueKey":"profiles","typeLabel":"object[]"},"social":{"type":"array","description":"Social posts, when the search found any.","items":{"type":"object","properties":{"title":{"type":"string","description":"Page title.","isRequired":true,"uniqueKey":"social.items.[INDEX].title","typeLabel":"string"},"link":{"type":"string","format":"uri","description":"Page URL.","isRequired":true,"uniqueKey":"social.items.[INDEX].link","typeLabel":"string\u003curi>"},"desc":{"type":"string","description":"Page description or summary.","isRequired":true,"uniqueKey":"social.items.[INDEX].desc","typeLabel":"string"},"source":{"type":"string","description":"Site or publisher name (for example `Wikipedia`); a name derived from the domain when none is known.","isRequired":true,"uniqueKey":"social.items.[INDEX].source","typeLabel":"string"},"type":{"type":"string","description":"Result type. Only included when `metadata=full`.","enum":["website","blog","news","video","image","place","profile","social","academic","calculation","weather","computation","instant answer"],"uniqueKey":"social.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"date":{"type":"string","description":"Publication date of the content, when available.","uniqueKey":"social.items.[INDEX].date","typeLabel":"string"},"dateModified":{"type":"string","description":"When the page was last updated, if known.","uniqueKey":"social.items.[INDEX].dateModified","typeLabel":"string"},"image":{"type":"string","format":"uri","description":"Preview image URL, when available. Only included when `metadata=full`.","uniqueKey":"social.items.[INDEX].image","typeLabel":"string\u003curi>"},"snippet":{"type":"string","description":"Query-relevant text excerpt from the page. Distinct from `desc`, which is the general page description.","uniqueKey":"social.items.[INDEX].snippet","typeLabel":"string"},"answer":{"type":"string","description":"Inline answer for instant answer results.","uniqueKey":"social.items.[INDEX].answer","typeLabel":"string"},"extracts":{"type":"array","items":{"type":"string","uniqueKey":"social.items.[INDEX].extracts.items.[INDEX]","typeLabel":"string"},"description":"Query-relevant passages from the page. Returned with `extracts=true`, and by default with `format=context`, `content=true` and `metadata=full`.","uniqueKey":"social.items.[INDEX].extracts","typeLabel":"string[]"},"contentType":{"type":"string","description":"Content type of the page. Only included when `metadata=full`.","uniqueKey":"social.items.[INDEX].contentType","typeLabel":"string"},"reader":{"type":"object","description":"Extracted page content and metadata. Included with `metadata=full`; with `content=true` it holds the full page text in `reader.markdown` (or `reader.content`) at any metadata level.","uniqueKey":"social.items.[INDEX].reader","typeLabel":"object"},"contentSafety":{"type":"object","description":"Safety classification. Only included when `metadata=full`.","properties":{"rating":{"type":"string","enum":["safe","unsafe","unknown"],"description":"Content safety rating.","uniqueKey":"social.items.[INDEX].contentSafety.rating","typeLabel":"enum\u003cstring>"},"safeSearchApplied":{"type":"boolean","description":"Whether safe-search filtering was applied to this result.","uniqueKey":"social.items.[INDEX].contentSafety.safeSearchApplied","typeLabel":"boolean"}},"uniqueKey":"social.items.[INDEX].contentSafety","typeLabel":"object"},"bang":{"type":"string","description":"Bang shortcut for the result domain. Only included when `metadata=full`.","uniqueKey":"social.items.[INDEX].bang","typeLabel":"string"},"queryIndices":{"type":"array","items":{"type":"integer","uniqueKey":"social.items.[INDEX].queryIndices.items.[INDEX]","typeLabel":"integer"},"description":"Multi-query only: which of your queries (0-based) found this result.","uniqueKey":"social.items.[INDEX].queryIndices","typeLabel":"integer[]"},"language":{"type":"string","description":"The page's language as a lower-case primary tag, for example `fr`. Left out when unknown.","uniqueKey":"social.items.[INDEX].language","typeLabel":"string"},"site_country":{"type":"string","description":"ISO 3166-1 country code named by the site's country-code domain, for example `DE` for `.de`. Generic domains such as `.com` have none.","uniqueKey":"social.items.[INDEX].site_country","typeLabel":"string"},"availability":{"type":"object","description":"Present only when something is wrong with the site or this page. `link` is never changed. Left out for healthy results.","properties":{"state":{"type":"string","enum":["redirected","parked","repurposed","hijacked","likely_dead","dead","gone"],"description":"`redirected`: the site has moved (see `movedTo`). `parked`: the domain is parked or for sale. `repurposed`: the domain now hosts unrelated content. `hijacked`: the domain was taken over. `likely_dead`: repeated checks over weeks failed. `dead`: the site is confirmed offline. `gone`: this one page was removed.","isRequired":true,"uniqueKey":"social.items.[INDEX].availability.state","typeLabel":"enum\u003cstring>"},"scope":{"type":"string","enum":["site","page"],"description":"`site` when the whole site is affected, `page` when only this page is (`gone`).","isRequired":true,"uniqueKey":"social.items.[INDEX].availability.scope","typeLabel":"enum\u003cstring>"},"source":{"type":"string","enum":["probe","rdap","origin","curated","page"],"description":"Who decided: Andi's own site checks (`probe`), the domain registry (`rdap`), the page's own server (`origin`), a curated list (`curated`), or the result's own title and snippet, which read as a parked or for-sale page (`page`).","isRequired":true,"uniqueKey":"social.items.[INDEX].availability.source","typeLabel":"enum\u003cstring>"},"since":{"type":"string","format":"date-time","description":"When the state was first seen, when known.","uniqueKey":"social.items.[INDEX].availability.since","typeLabel":"string\u003cdate-time>"},"checkedAt":{"type":"string","format":"date-time","description":"When the state was last checked, when known.","uniqueKey":"social.items.[INDEX].availability.checkedAt","typeLabel":"string\u003cdate-time>"},"movedTo":{"type":"string","description":"Host the site moved to. Only with `state: redirected`.","uniqueKey":"social.items.[INDEX].availability.movedTo","typeLabel":"string"}},"required":["state","scope","source"],"uniqueKey":"social.items.[INDEX].availability","typeLabel":"object"},"archive":{"type":"array","description":"Saved copies of this exact page, newest first; the first entry is the best one. Present only on results that have `availability`.","items":{"type":"object","properties":{"source":{"type":"string","description":"Where the copy is kept: `wayback` (Internet Archive) or `andi` (Andi's own stored copy).","isRequired":true,"uniqueKey":"social.items.[INDEX].archive.items.[INDEX].source","typeLabel":"string"},"url":{"oneOf":[{"type":"string","description":"Public address of the copy. `null` for Andi's own copy, which has no public address: read it with the fetch endpoint using the result's `link`.","isRequired":true,"uniqueKey":"social.items.[INDEX].archive.items.[INDEX].url.oneOf.0","typeLabel":"string"},{"type":"null","description":"Public address of the copy. `null` for Andi's own copy, which has no public address: read it with the fetch endpoint using the result's `link`.","isRequired":true,"uniqueKey":"social.items.[INDEX].archive.items.[INDEX].url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"social.items.[INDEX].archive.items.[INDEX].url","typeLabel":"string | null"},"capturedAt":{"type":"string","format":"date-time","description":"When the copy was saved.","uniqueKey":"social.items.[INDEX].archive.items.[INDEX].capturedAt","typeLabel":"string\u003cdate-time>"}},"required":["source","url"],"uniqueKey":"social.items.[INDEX].archive.items.[INDEX]","typeLabel":"object"},"uniqueKey":"social.items.[INDEX].archive","typeLabel":"object[]"},"seeAlso":{"type":"array","description":"News feeds only: other outlets covering the same story.","items":{"type":"object","properties":{"title":{"type":"string","uniqueKey":"social.items.[INDEX].seeAlso.items.[INDEX].title","typeLabel":"string"},"url":{"type":"string","format":"uri","uniqueKey":"social.items.[INDEX].seeAlso.items.[INDEX].url","typeLabel":"string\u003curi>"},"source":{"type":"string","uniqueKey":"social.items.[INDEX].seeAlso.items.[INDEX].source","typeLabel":"string"}},"uniqueKey":"social.items.[INDEX].seeAlso.items.[INDEX]","typeLabel":"object"},"uniqueKey":"social.items.[INDEX].seeAlso","typeLabel":"object[]"},"truncated":{"type":"boolean","description":"`true` when the result shows less page text than the page holds (cut to fit `maxTokens`, or focused to the parts that answer the query). A result with only a snippet or extracts is marked only when the budget cut it. Fetch the page's URL for the rest.","uniqueKey":"social.items.[INDEX].truncated","typeLabel":"boolean"},"shown_words":{"type":"integer","description":"Words of page text this result shows. Present with `truncated`.","uniqueKey":"social.items.[INDEX].shown_words","typeLabel":"integer"},"total_words":{"type":"integer","description":"Words the whole page holds. Present with `truncated`.","uniqueKey":"social.items.[INDEX].total_words","typeLabel":"integer"}},"required":["title","link","desc","source"],"uniqueKey":"social.items.[INDEX]","typeLabel":"object"},"uniqueKey":"social","typeLabel":"object[]"},"academic":{"type":"array","description":"Scholarly papers, when the search found any.","items":{"type":"object","properties":{"title":{"type":"string","description":"Page title.","isRequired":true,"uniqueKey":"academic.items.[INDEX].title","typeLabel":"string"},"link":{"type":"string","format":"uri","description":"Page URL.","isRequired":true,"uniqueKey":"academic.items.[INDEX].link","typeLabel":"string\u003curi>"},"desc":{"type":"string","description":"Page description or summary.","isRequired":true,"uniqueKey":"academic.items.[INDEX].desc","typeLabel":"string"},"source":{"type":"string","description":"Site or publisher name (for example `Wikipedia`); a name derived from the domain when none is known.","isRequired":true,"uniqueKey":"academic.items.[INDEX].source","typeLabel":"string"},"type":{"type":"string","description":"Result type. Only included when `metadata=full`.","enum":["website","blog","news","video","image","place","profile","social","academic","calculation","weather","computation","instant answer"],"uniqueKey":"academic.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"date":{"type":"string","description":"Publication date of the content, when available.","uniqueKey":"academic.items.[INDEX].date","typeLabel":"string"},"dateModified":{"type":"string","description":"When the page was last updated, if known.","uniqueKey":"academic.items.[INDEX].dateModified","typeLabel":"string"},"image":{"type":"string","format":"uri","description":"Preview image URL, when available. Only included when `metadata=full`.","uniqueKey":"academic.items.[INDEX].image","typeLabel":"string\u003curi>"},"snippet":{"type":"string","description":"Query-relevant text excerpt from the page. Distinct from `desc`, which is the general page description.","uniqueKey":"academic.items.[INDEX].snippet","typeLabel":"string"},"answer":{"type":"string","description":"Inline answer for instant answer results.","uniqueKey":"academic.items.[INDEX].answer","typeLabel":"string"},"extracts":{"type":"array","items":{"type":"string","uniqueKey":"academic.items.[INDEX].extracts.items.[INDEX]","typeLabel":"string"},"description":"Query-relevant passages from the page. Returned with `extracts=true`, and by default with `format=context`, `content=true` and `metadata=full`.","uniqueKey":"academic.items.[INDEX].extracts","typeLabel":"string[]"},"contentType":{"type":"string","description":"Content type of the page. Only included when `metadata=full`.","uniqueKey":"academic.items.[INDEX].contentType","typeLabel":"string"},"reader":{"type":"object","description":"Extracted page content and metadata. Included with `metadata=full`; with `content=true` it holds the full page text in `reader.markdown` (or `reader.content`) at any metadata level.","uniqueKey":"academic.items.[INDEX].reader","typeLabel":"object"},"contentSafety":{"type":"object","description":"Safety classification. Only included when `metadata=full`.","properties":{"rating":{"type":"string","enum":["safe","unsafe","unknown"],"description":"Content safety rating.","uniqueKey":"academic.items.[INDEX].contentSafety.rating","typeLabel":"enum\u003cstring>"},"safeSearchApplied":{"type":"boolean","description":"Whether safe-search filtering was applied to this result.","uniqueKey":"academic.items.[INDEX].contentSafety.safeSearchApplied","typeLabel":"boolean"}},"uniqueKey":"academic.items.[INDEX].contentSafety","typeLabel":"object"},"bang":{"type":"string","description":"Bang shortcut for the result domain. Only included when `metadata=full`.","uniqueKey":"academic.items.[INDEX].bang","typeLabel":"string"},"queryIndices":{"type":"array","items":{"type":"integer","uniqueKey":"academic.items.[INDEX].queryIndices.items.[INDEX]","typeLabel":"integer"},"description":"Multi-query only: which of your queries (0-based) found this result.","uniqueKey":"academic.items.[INDEX].queryIndices","typeLabel":"integer[]"},"language":{"type":"string","description":"The page's language as a lower-case primary tag, for example `fr`. Left out when unknown.","uniqueKey":"academic.items.[INDEX].language","typeLabel":"string"},"site_country":{"type":"string","description":"ISO 3166-1 country code named by the site's country-code domain, for example `DE` for `.de`. Generic domains such as `.com` have none.","uniqueKey":"academic.items.[INDEX].site_country","typeLabel":"string"},"availability":{"type":"object","description":"Present only when something is wrong with the site or this page. `link` is never changed. Left out for healthy results.","properties":{"state":{"type":"string","enum":["redirected","parked","repurposed","hijacked","likely_dead","dead","gone"],"description":"`redirected`: the site has moved (see `movedTo`). `parked`: the domain is parked or for sale. `repurposed`: the domain now hosts unrelated content. `hijacked`: the domain was taken over. `likely_dead`: repeated checks over weeks failed. `dead`: the site is confirmed offline. `gone`: this one page was removed.","isRequired":true,"uniqueKey":"academic.items.[INDEX].availability.state","typeLabel":"enum\u003cstring>"},"scope":{"type":"string","enum":["site","page"],"description":"`site` when the whole site is affected, `page` when only this page is (`gone`).","isRequired":true,"uniqueKey":"academic.items.[INDEX].availability.scope","typeLabel":"enum\u003cstring>"},"source":{"type":"string","enum":["probe","rdap","origin","curated","page"],"description":"Who decided: Andi's own site checks (`probe`), the domain registry (`rdap`), the page's own server (`origin`), a curated list (`curated`), or the result's own title and snippet, which read as a parked or for-sale page (`page`).","isRequired":true,"uniqueKey":"academic.items.[INDEX].availability.source","typeLabel":"enum\u003cstring>"},"since":{"type":"string","format":"date-time","description":"When the state was first seen, when known.","uniqueKey":"academic.items.[INDEX].availability.since","typeLabel":"string\u003cdate-time>"},"checkedAt":{"type":"string","format":"date-time","description":"When the state was last checked, when known.","uniqueKey":"academic.items.[INDEX].availability.checkedAt","typeLabel":"string\u003cdate-time>"},"movedTo":{"type":"string","description":"Host the site moved to. Only with `state: redirected`.","uniqueKey":"academic.items.[INDEX].availability.movedTo","typeLabel":"string"}},"required":["state","scope","source"],"uniqueKey":"academic.items.[INDEX].availability","typeLabel":"object"},"archive":{"type":"array","description":"Saved copies of this exact page, newest first; the first entry is the best one. Present only on results that have `availability`.","items":{"type":"object","properties":{"source":{"type":"string","description":"Where the copy is kept: `wayback` (Internet Archive) or `andi` (Andi's own stored copy).","isRequired":true,"uniqueKey":"academic.items.[INDEX].archive.items.[INDEX].source","typeLabel":"string"},"url":{"oneOf":[{"type":"string","description":"Public address of the copy. `null` for Andi's own copy, which has no public address: read it with the fetch endpoint using the result's `link`.","isRequired":true,"uniqueKey":"academic.items.[INDEX].archive.items.[INDEX].url.oneOf.0","typeLabel":"string"},{"type":"null","description":"Public address of the copy. `null` for Andi's own copy, which has no public address: read it with the fetch endpoint using the result's `link`.","isRequired":true,"uniqueKey":"academic.items.[INDEX].archive.items.[INDEX].url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"academic.items.[INDEX].archive.items.[INDEX].url","typeLabel":"string | null"},"capturedAt":{"type":"string","format":"date-time","description":"When the copy was saved.","uniqueKey":"academic.items.[INDEX].archive.items.[INDEX].capturedAt","typeLabel":"string\u003cdate-time>"}},"required":["source","url"],"uniqueKey":"academic.items.[INDEX].archive.items.[INDEX]","typeLabel":"object"},"uniqueKey":"academic.items.[INDEX].archive","typeLabel":"object[]"},"seeAlso":{"type":"array","description":"News feeds only: other outlets covering the same story.","items":{"type":"object","properties":{"title":{"type":"string","uniqueKey":"academic.items.[INDEX].seeAlso.items.[INDEX].title","typeLabel":"string"},"url":{"type":"string","format":"uri","uniqueKey":"academic.items.[INDEX].seeAlso.items.[INDEX].url","typeLabel":"string\u003curi>"},"source":{"type":"string","uniqueKey":"academic.items.[INDEX].seeAlso.items.[INDEX].source","typeLabel":"string"}},"uniqueKey":"academic.items.[INDEX].seeAlso.items.[INDEX]","typeLabel":"object"},"uniqueKey":"academic.items.[INDEX].seeAlso","typeLabel":"object[]"},"truncated":{"type":"boolean","description":"`true` when the result shows less page text than the page holds (cut to fit `maxTokens`, or focused to the parts that answer the query). A result with only a snippet or extracts is marked only when the budget cut it. Fetch the page's URL for the rest.","uniqueKey":"academic.items.[INDEX].truncated","typeLabel":"boolean"},"shown_words":{"type":"integer","description":"Words of page text this result shows. Present with `truncated`.","uniqueKey":"academic.items.[INDEX].shown_words","typeLabel":"integer"},"total_words":{"type":"integer","description":"Words the whole page holds. Present with `truncated`.","uniqueKey":"academic.items.[INDEX].total_words","typeLabel":"integer"}},"required":["title","link","desc","source"],"uniqueKey":"academic.items.[INDEX]","typeLabel":"object"},"uniqueKey":"academic","typeLabel":"object[]"},"weather":{"type":"object","properties":{"location":{"type":"object","description":"Location details.","properties":{"name":{"type":"string","description":"Location name.","uniqueKey":"weather.location.name","typeLabel":"string"},"region":{"type":"string","description":"State or province, for example `Missouri`. Absent when not known.","uniqueKey":"weather.location.region","typeLabel":"string"},"country":{"type":"string","description":"Two-letter country code (ISO 3166-1 alpha-2), for example `US`. Empty when not known.","uniqueKey":"weather.location.country","typeLabel":"string"},"countryName":{"type":"string","description":"Country name in English, for example `United States`.","uniqueKey":"weather.location.countryName","typeLabel":"string"},"coordinates":{"type":"object","properties":{"latitude":{"type":"number","uniqueKey":"weather.location.coordinates.latitude","typeLabel":"number"},"longitude":{"type":"number","uniqueKey":"weather.location.coordinates.longitude","typeLabel":"number"}},"uniqueKey":"weather.location.coordinates","typeLabel":"object"}},"isRequired":true,"uniqueKey":"weather.location","typeLabel":"object"},"temperature":{"type":"number","description":"Current temperature.","isRequired":true,"uniqueKey":"weather.temperature","typeLabel":"number"},"units":{"type":"string","description":"Unit system: `metric` or `imperial`.","enum":["metric","imperial"],"isRequired":true,"uniqueKey":"weather.units","typeLabel":"enum\u003cstring>"},"description":{"type":"string","description":"Weather condition description.","isRequired":true,"uniqueKey":"weather.description","typeLabel":"string"},"feelsLike":{"type":"number","description":"Feels-like temperature.","uniqueKey":"weather.feelsLike","typeLabel":"number"},"humidity":{"type":"number","description":"Humidity percentage.","uniqueKey":"weather.humidity","typeLabel":"number"},"windSpeed":{"type":"number","description":"Wind speed: km/h when `units` is `metric`, mph when `imperial`.","uniqueKey":"weather.windSpeed","typeLabel":"number"},"windDirection":{"type":"number","description":"Wind direction in degrees.","uniqueKey":"weather.windDirection","typeLabel":"number"},"pressure":{"type":"number","description":"Atmospheric pressure.","uniqueKey":"weather.pressure","typeLabel":"number"},"icon":{"type":"string","description":"Weather icon code, for example `01d`.","uniqueKey":"weather.icon","typeLabel":"string"},"cloudiness":{"type":"number","description":"Cloud cover percentage.","uniqueKey":"weather.cloudiness","typeLabel":"number"},"visibility":{"type":"number","description":"Visibility: km when `units` is `metric`, miles when `imperial`.","uniqueKey":"weather.visibility","typeLabel":"number"},"weatherCode":{"type":"integer","description":"Weather condition code, always in the WMO code set.","uniqueKey":"weather.weatherCode","typeLabel":"integer"},"uvIndex":{"type":"number","description":"UV index. Present when known.","uniqueKey":"weather.uvIndex","typeLabel":"number"},"timezone":{"type":"string","description":"The place's time zone, for example `America/Chicago`.","uniqueKey":"weather.timezone","typeLabel":"string"},"utcOffsetMinutes":{"type":"integer","description":"The place's current offset from UTC, in minutes.","uniqueKey":"weather.utcOffsetMinutes","typeLabel":"integer"},"isDay":{"type":"boolean","description":"`true` when the sun is up at the place now.","uniqueKey":"weather.isDay","typeLabel":"boolean"},"sunrise":{"type":"string","description":"Today's sunrise at the place, ISO 8601 with offset.","uniqueKey":"weather.sunrise","typeLabel":"string"},"sunset":{"type":"string","description":"Today's sunset at the place, ISO 8601 with offset.","uniqueKey":"weather.sunset","typeLabel":"string"},"requested":{"type":"object","description":"Present when a day other than now was asked for (\"friday\", \"tomorrow\", \"tonight\", \"this weekend\", a date).","properties":{"day":{"type":"string","description":"The day asked for, as a local date (YYYY-MM-DD).","uniqueKey":"weather.requested.day","typeLabel":"string"},"days":{"type":"array","items":{"type":"string","uniqueKey":"weather.requested.days.items.[INDEX]","typeLabel":"string"},"description":"The days asked for, when more than one.","uniqueKey":"weather.requested.days","typeLabel":"string[]"},"label":{"type":"string","description":"The asked-for day as written, for example `friday`.","uniqueKey":"weather.requested.label","typeLabel":"string"},"tonight":{"type":"boolean","description":"`true` when tonight was asked for.","uniqueKey":"weather.requested.tonight","typeLabel":"boolean"}},"uniqueKey":"weather.requested","typeLabel":"object"},"forecast":{"type":"array","description":"One entry per requested day. Temperatures use `units`.","items":{"type":"object","properties":{"date":{"type":"string","description":"Local date, YYYY-MM-DD.","isRequired":true,"uniqueKey":"weather.forecast.items.[INDEX].date","typeLabel":"string"},"high":{"type":"number","description":"Highest temperature.","isRequired":true,"uniqueKey":"weather.forecast.items.[INDEX].high","typeLabel":"number"},"low":{"type":"number","description":"Lowest temperature.","isRequired":true,"uniqueKey":"weather.forecast.items.[INDEX].low","typeLabel":"number"},"weatherCode":{"type":"integer","description":"Weather condition code (WMO).","uniqueKey":"weather.forecast.items.[INDEX].weatherCode","typeLabel":"integer"},"icon":{"type":"string","description":"Weather icon code.","uniqueKey":"weather.forecast.items.[INDEX].icon","typeLabel":"string"},"precipitationChance":{"type":"number","description":"Chance of precipitation, percent.","uniqueKey":"weather.forecast.items.[INDEX].precipitationChance","typeLabel":"number"},"windSpeedMax":{"type":"number","description":"Highest wind speed: km/h metric, mph imperial.","uniqueKey":"weather.forecast.items.[INDEX].windSpeedMax","typeLabel":"number"},"sunrise":{"type":"string","description":"Sunrise, ISO 8601 with offset.","uniqueKey":"weather.forecast.items.[INDEX].sunrise","typeLabel":"string"},"sunset":{"type":"string","description":"Sunset, ISO 8601 with offset.","uniqueKey":"weather.forecast.items.[INDEX].sunset","typeLabel":"string"}},"required":["date","high","low"],"uniqueKey":"weather.forecast.items.[INDEX]","typeLabel":"object"},"uniqueKey":"weather.forecast","typeLabel":"object[]"},"available":{"type":"string","enum":["current"],"description":"`current` when a day was asked for but only current conditions can be given (or the day is too far ahead). The block is then not the answer to the question.","uniqueKey":"weather.available","typeLabel":"enum\u003cstring>"},"timestamp":{"type":"integer","description":"Time of the reading, Unix epoch milliseconds.","uniqueKey":"weather.timestamp","typeLabel":"integer"},"asOf":{"type":"string","description":"When the reading was taken, as an ISO 8601 time.","uniqueKey":"weather.asOf","typeLabel":"string"},"source":{"type":"object","description":"Who supplied the figures.","properties":{"name":{"type":"string","description":"Publisher name.","isRequired":true,"uniqueKey":"weather.source.name","typeLabel":"string"},"url":{"type":"string","format":"uri","description":"Link to the publisher's page for these figures.","uniqueKey":"weather.source.url","typeLabel":"string\u003curi>"}},"required":["name"],"uniqueKey":"weather.source","typeLabel":"object"},"hourly":{"type":"array","description":"The next six hours, in the place's local time.","items":{"type":"object","properties":{"time":{"type":"string","description":"Local time, ISO 8601 with offset.","isRequired":true,"uniqueKey":"weather.hourly.items.[INDEX].time","typeLabel":"string"},"temperature":{"type":"number","description":"Temperature.","isRequired":true,"uniqueKey":"weather.hourly.items.[INDEX].temperature","typeLabel":"number"},"weatherCode":{"type":"integer","description":"Weather condition code.","uniqueKey":"weather.hourly.items.[INDEX].weatherCode","typeLabel":"integer"},"icon":{"type":"string","description":"Weather icon identifier.","uniqueKey":"weather.hourly.items.[INDEX].icon","typeLabel":"string"}},"required":["time","temperature"],"uniqueKey":"weather.hourly.items.[INDEX]","typeLabel":"object"},"uniqueKey":"weather.hourly","typeLabel":"object[]"}},"required":["location","temperature","units","description"],"description":"Weather data. Present when the query triggers a weather intent.","uniqueKey":"weather","typeLabel":"object"},"calculation":{"type":"object","properties":{"expression":{"type":"string","description":"The mathematical expression.","isRequired":true,"uniqueKey":"calculation.expression","typeLabel":"string"},"result":{"type":"string","description":"The calculated result.","isRequired":true,"uniqueKey":"calculation.result","typeLabel":"string"},"rawResult":{"description":"The unformatted result (usually a number).","uniqueKey":"calculation.rawResult","typeLabel":"any"}},"required":["expression","result"],"description":"Calculation result. Present when the query triggers a calculation intent.","uniqueKey":"calculation","typeLabel":"object"},"preset":{"type":"object","description":"Which preset ran, how it was chosen and the defaults it filled in. Present only when a preset was chosen by `preset=` or by the calling surface (MCP server, CLI).","properties":{"name":{"type":"string","enum":["app","agent"],"uniqueKey":"preset.name","typeLabel":"enum\u003cstring>"},"from":{"type":"string","enum":["param","surface"],"uniqueKey":"preset.from","typeLabel":"enum\u003cstring>"},"filled":{"type":"array","items":{"type":"string","uniqueKey":"preset.filled.items.[INDEX]","typeLabel":"string"},"description":"`key=value` for each default the preset filled in, e.g. `format=context`.","uniqueKey":"preset.filled","typeLabel":"string[]"}},"uniqueKey":"preset","typeLabel":"object"},"warnings":{"type":"array","items":{"type":"string","uniqueKey":"warnings.items.[INDEX]","typeLabel":"string"},"description":"Notes on parts of the request the API adjusted or ignored, for example a `limit` above 10 lowered to 10 on `instant`.","uniqueKey":"warnings","typeLabel":"string[]"},"time":{"type":"object","description":"Present when the query is a time or clock query.","properties":{"zone":{"type":"string","description":"IANA time zone, for example `Asia/Tokyo`.","isRequired":true,"uniqueKey":"time.zone","typeLabel":"string"},"city":{"type":"string","description":"City name.","uniqueKey":"time.city","typeLabel":"string"},"country":{"type":"string","description":"ISO 3166-1 alpha-2 country code.","uniqueKey":"time.country","typeLabel":"string"},"zoneName":{"type":"string","description":"Long zone name, for example `Japan Standard Time`.","uniqueKey":"time.zoneName","typeLabel":"string"},"utcOffsetMinutes":{"type":"integer","description":"Offset from UTC in minutes.","uniqueKey":"time.utcOffsetMinutes","typeLabel":"integer"},"source":{"type":"object","description":"Who supplied the figures.","properties":{"name":{"type":"string","description":"Publisher name.","isRequired":true,"uniqueKey":"time.source.name","typeLabel":"string"},"url":{"type":"string","format":"uri","description":"Link to the publisher's page for these figures.","uniqueKey":"time.source.url","typeLabel":"string\u003curi>"}},"required":["name"],"uniqueKey":"time.source","typeLabel":"object"},"asOf":{"type":"string","description":"When the figures were true, as an ISO 8601 time.","uniqueKey":"time.asOf","typeLabel":"string"},"stale":{"type":"boolean","description":"`true` when the latest figures could not be read and the last good copy is shown.","uniqueKey":"time.stale","typeLabel":"boolean"}},"required":["zone"],"uniqueKey":"time","typeLabel":"object"},"currency":{"type":"object","description":"Present when the query is a currency conversion query.","properties":{"fromAmount":{"type":"number","description":"Amount converted.","isRequired":true,"uniqueKey":"currency.fromAmount","typeLabel":"number"},"fromCurrency":{"type":"string","description":"Source currency code.","isRequired":true,"uniqueKey":"currency.fromCurrency","typeLabel":"string"},"toAmount":{"type":"number","description":"Converted amount.","isRequired":true,"uniqueKey":"currency.toAmount","typeLabel":"number"},"toCurrency":{"type":"string","description":"Target currency code.","isRequired":true,"uniqueKey":"currency.toCurrency","typeLabel":"string"},"rate":{"type":"number","description":"Exchange rate used.","isRequired":true,"uniqueKey":"currency.rate","typeLabel":"number"},"series":{"type":"array","items":{"type":"number","uniqueKey":"currency.series.items.[INDEX]","typeLabel":"number"},"description":"Rates for the last 30 days, one per publishing day, oldest first.","uniqueKey":"currency.series","typeLabel":"number[]"},"source":{"type":"object","description":"Who supplied the figures.","properties":{"name":{"type":"string","description":"Publisher name.","isRequired":true,"uniqueKey":"currency.source.name","typeLabel":"string"},"url":{"type":"string","format":"uri","description":"Link to the publisher's page for these figures.","uniqueKey":"currency.source.url","typeLabel":"string\u003curi>"}},"required":["name"],"uniqueKey":"currency.source","typeLabel":"object"},"asOf":{"type":"string","description":"Date of the rate, as an ISO 8601 date.","uniqueKey":"currency.asOf","typeLabel":"string"},"stale":{"type":"boolean","description":"`true` when the latest figures could not be read and the last good copy is shown.","uniqueKey":"currency.stale","typeLabel":"boolean"}},"required":["fromAmount","fromCurrency","toAmount","toCurrency","rate"],"uniqueKey":"currency","typeLabel":"object"},"translation":{"type":"object","description":"Present when the query is a translation query.","properties":{"sourceText":{"type":"string","description":"Text you asked to translate.","isRequired":true,"uniqueKey":"translation.sourceText","typeLabel":"string"},"text":{"type":"string","description":"Translated text.","isRequired":true,"uniqueKey":"translation.text","typeLabel":"string"},"from":{"type":"string","description":"Source language name, for example `English`.","isRequired":true,"uniqueKey":"translation.from","typeLabel":"string"},"to":{"type":"string","description":"Target language name.","isRequired":true,"uniqueKey":"translation.to","typeLabel":"string"},"fromCode":{"type":"string","description":"Source language code, for example `en`.","isRequired":true,"uniqueKey":"translation.fromCode","typeLabel":"string"},"toCode":{"type":"string","description":"Target language code.","isRequired":true,"uniqueKey":"translation.toCode","typeLabel":"string"},"pronunciation":{"type":"string","description":"Reading in Latin letters, when the target language uses another script.","uniqueKey":"translation.pronunciation","typeLabel":"string"},"method":{"type":"string","enum":["machine","llm"],"description":"How it was translated: `machine` for a plain request, `llm` when the request needed tone, context or an idiom read with care. When `llm`, `source.name` is `Andi`.","uniqueKey":"translation.method","typeLabel":"enum\u003cstring>"},"source":{"type":"object","description":"Who supplied the figures.","properties":{"name":{"type":"string","description":"Publisher name.","isRequired":true,"uniqueKey":"translation.source.name","typeLabel":"string"},"url":{"type":"string","format":"uri","description":"Link to the publisher's page for these figures.","uniqueKey":"translation.source.url","typeLabel":"string\u003curi>"}},"required":["name"],"uniqueKey":"translation.source","typeLabel":"object"},"asOf":{"type":"string","description":"When the figures were true, as an ISO 8601 time.","uniqueKey":"translation.asOf","typeLabel":"string"},"stale":{"type":"boolean","description":"`true` when the latest figures could not be read and the last good copy is shown.","uniqueKey":"translation.stale","typeLabel":"boolean"}},"required":["sourceText","text","from","to","fromCode","toCode"],"uniqueKey":"translation","typeLabel":"object"},"quote":{"type":"object","description":"Present when the query is a share price query.","properties":{"symbol":{"type":"string","description":"Ticker symbol.","isRequired":true,"uniqueKey":"quote.symbol","typeLabel":"string"},"price":{"type":"number","description":"Latest price.","isRequired":true,"uniqueKey":"quote.price","typeLabel":"number"},"name":{"type":"string","description":"Company name.","uniqueKey":"quote.name","typeLabel":"string"},"exchange":{"type":"string","description":"Exchange.","uniqueKey":"quote.exchange","typeLabel":"string"},"currency":{"type":"string","description":"Price currency code.","uniqueKey":"quote.currency","typeLabel":"string"},"change":{"type":"number","description":"Change since the previous close.","uniqueKey":"quote.change","typeLabel":"number"},"changePercent":{"type":"number","description":"Change since the previous close, as a percent.","uniqueKey":"quote.changePercent","typeLabel":"number"},"previousClose":{"type":"number","description":"Previous close.","uniqueKey":"quote.previousClose","typeLabel":"number"},"open":{"type":"number","description":"Opening price.","uniqueKey":"quote.open","typeLabel":"number"},"low":{"type":"number","description":"Day low.","uniqueKey":"quote.low","typeLabel":"number"},"high":{"type":"number","description":"Day high.","uniqueKey":"quote.high","typeLabel":"number"},"marketState":{"type":"string","enum":["open","closed","pre","post"],"description":"Market state.","uniqueKey":"quote.marketState","typeLabel":"enum\u003cstring>"},"close":{"type":"number","description":"The regular-session closing price, shown when the market is not open (`pre`, `post` or `closed`).","uniqueKey":"quote.close","typeLabel":"number"},"extendedPrice":{"type":"number","description":"The after-hours price, while `marketState` is `post`.","uniqueKey":"quote.extendedPrice","typeLabel":"number"},"extendedChange":{"type":"number","description":"The after-hours change from the close, while `marketState` is `post`.","uniqueKey":"quote.extendedChange","typeLabel":"number"},"delayMinutes":{"type":"number","description":"Minutes the price is delayed, when delayed.","uniqueKey":"quote.delayMinutes","typeLabel":"number"},"series":{"type":"array","items":{"type":"number","uniqueKey":"quote.series.items.[INDEX]","typeLabel":"number"},"description":"The day's prices in 5-minute steps, oldest first.","uniqueKey":"quote.series","typeLabel":"number[]"},"refresh":{"type":"string","description":"Pass to `GET /api/v1/data/refresh` as `ref`. Present only while the market is open, pre or post.","uniqueKey":"quote.refresh","typeLabel":"string"},"source":{"type":"object","description":"Who supplied the figures.","properties":{"name":{"type":"string","description":"Publisher name.","isRequired":true,"uniqueKey":"quote.source.name","typeLabel":"string"},"url":{"type":"string","format":"uri","description":"Link to the publisher's page for these figures.","uniqueKey":"quote.source.url","typeLabel":"string\u003curi>"}},"required":["name"],"uniqueKey":"quote.source","typeLabel":"object"},"asOf":{"type":"string","description":"When the figures were true, as an ISO 8601 time.","uniqueKey":"quote.asOf","typeLabel":"string"},"stale":{"type":"boolean","description":"`true` when the latest figures could not be read and the last good copy is shown.","uniqueKey":"quote.stale","typeLabel":"boolean"}},"required":["symbol","price"],"uniqueKey":"quote","typeLabel":"object"},"score":{"type":"object","description":"Present when the query is a game score query.","properties":{"league":{"type":"string","description":"League name.","isRequired":true,"uniqueKey":"score.league","typeLabel":"string"},"status":{"type":"string","enum":["scheduled","live","halftime","final","postponed","cancelled"],"description":"Game status.","isRequired":true,"uniqueKey":"score.status","typeLabel":"enum\u003cstring>"},"teams":{"type":"array","description":"The teams.","items":{"type":"object","properties":{"name":{"type":"string","description":"Team name.","isRequired":true,"uniqueKey":"score.teams.items.[INDEX].name","typeLabel":"string"},"shortName":{"type":"string","description":"Short name.","uniqueKey":"score.teams.items.[INDEX].shortName","typeLabel":"string"},"logo":{"type":"string","description":"Logo URL.","uniqueKey":"score.teams.items.[INDEX].logo","typeLabel":"string"},"score":{"type":"integer","description":"Team score.","uniqueKey":"score.teams.items.[INDEX].score","typeLabel":"integer"},"home":{"type":"boolean","description":"`true` for the home team.","uniqueKey":"score.teams.items.[INDEX].home","typeLabel":"boolean"}},"required":["name"],"uniqueKey":"score.teams.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"score.teams","typeLabel":"object[]"},"clock":{"type":"string","description":"Game clock as text, for example `67'` or `Q3 4:12`.","uniqueKey":"score.clock","typeLabel":"string"},"startTime":{"type":"string","description":"Start time, ISO 8601.","uniqueKey":"score.startTime","typeLabel":"string"},"events":{"type":"array","items":{"type":"string","uniqueKey":"score.events.items.[INDEX]","typeLabel":"string"},"description":"Key moments, when known.","uniqueKey":"score.events","typeLabel":"string[]"},"reason":{"type":"string","description":"Why the game is postponed or cancelled.","uniqueKey":"score.reason","typeLabel":"string"},"games":{"type":"array","description":"The other games of a league or team search, in the same shape, nearest start first. Only on the top-level `score` block.","items":{"type":"object","uniqueKey":"score.games.items.[INDEX]","typeLabel":"object"},"uniqueKey":"score.games","typeLabel":"object[]"},"refresh":{"type":"string","description":"Pass to `GET /api/v1/data/refresh` as `ref`. Present only while the game is live or at half-time.","uniqueKey":"score.refresh","typeLabel":"string"},"source":{"type":"object","description":"Who supplied the figures.","properties":{"name":{"type":"string","description":"Publisher name.","isRequired":true,"uniqueKey":"score.source.name","typeLabel":"string"},"url":{"type":"string","format":"uri","description":"Link to the publisher's page for these figures.","uniqueKey":"score.source.url","typeLabel":"string\u003curi>"}},"required":["name"],"uniqueKey":"score.source","typeLabel":"object"},"asOf":{"type":"string","description":"When the figures were true, as an ISO 8601 time.","uniqueKey":"score.asOf","typeLabel":"string"},"stale":{"type":"boolean","description":"`true` when the latest figures could not be read and the last good copy is shown.","uniqueKey":"score.stale","typeLabel":"boolean"}},"required":["league","status","teams"],"uniqueKey":"score","typeLabel":"object"}},"required":["results_type","answer","type","title","results","metrics"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"results_type":"\u003cstring>","answer":"\u003cstring>","type":"\u003cstring>","title":"\u003cstring>","results":[{"title":"\u003cstring>","link":"\u003cstring>","desc":"\u003cstring>","source":"\u003cstring>","type":"website","date":"\u003cstring>","dateModified":"\u003cstring>","image":"\u003cstring>","snippet":"\u003cstring>","answer":"\u003cstring>","extracts":["\u003cstring>"],"contentType":"\u003cstring>","reader":{},"contentSafety":{"rating":"safe","safeSearchApplied":true},"bang":"\u003cstring>","queryIndices":[123],"language":"\u003cstring>","site_country":"\u003cstring>","availability":{"state":"redirected","scope":"site","source":"probe","since":"2023-11-07T05:31:56Z","checkedAt":"2023-11-07T05:31:56Z","movedTo":"\u003cstring>"},"archive":[{"source":"\u003cstring>","url":"\u003cstring>","capturedAt":"2023-11-07T05:31:56Z"}],"seeAlso":[{"title":"\u003cstring>","url":"\u003cstring>","source":"\u003cstring>"}],"truncated":true,"shown_words":123,"total_words":123}],"metrics":{"query":"\u003cstring>","intent":"\u003cstring>","timestamp":"\u003cstring>","duration":123,"queries_executed":123,"api_requests_count":123,"results_returned":123,"total_results_found":123,"queries_provided":123,"queries_truncated":123,"cached":true,"cache_age_seconds":123,"built_at":"\u003cstring>","max_age_seconds":123,"stale":true,"cost_dollars":123,"effort":"low","response_time_ms":123,"search_mode":"\u003cstring>","mode_reason":"\u003cstring>","mode_note":"\u003cstring>"},"answer_metadata":{"kind":"extractive","citations":["\u003cstring>"],"passage":"snippet","basis":"title","asOf":"\u003cstring>","asOfSource":"modified","block":"\u003cstring>","confidence":123,"clean":true,"consistent":true,"volatile":true,"current":true},"correctedQuery":"\u003cstring>","related_searches":["\u003cstring>"],"topics":["\u003cstring>"],"related_topics":["\u003cstring>"],"infobox":{"heading":"\u003cstring>","source":"\u003cstring>","items":[{"label":"\u003cstring>","value":"\u003cstring>"}]},"aiSummary":{"text":"\u003cstring>","generatedAt":"2023-11-07T05:31:56Z","model":"\u003cstring>","mode":"pregen"},"filter_counts":{"matched":123,"unknown":123},"locale":{"language":"de","languageConfidence":0.5,"languageSource":"param","country":"DE","localScope":"global"},"safeSearch":{"requested":"off","applied":"off"},"videos":[{"title":"\u003cstring>","link":"\u003cstring>","desc":"\u003cstring>","source":"\u003cstring>","type":"website","date":"\u003cstring>","dateModified":"\u003cstring>","image":"\u003cstring>","snippet":"\u003cstring>","answer":"\u003cstring>","extracts":["\u003cstring>"],"contentType":"\u003cstring>","reader":{},"contentSafety":{"rating":"safe","safeSearchApplied":true},"bang":"\u003cstring>","queryIndices":[123],"language":"\u003cstring>","site_country":"\u003cstring>","availability":{"state":"redirected","scope":"site","source":"probe","since":"2023-11-07T05:31:56Z","checkedAt":"2023-11-07T05:31:56Z","movedTo":"\u003cstring>"},"archive":[{"source":"\u003cstring>","url":"\u003cstring>","capturedAt":"2023-11-07T05:31:56Z"}],"seeAlso":[{"title":"\u003cstring>","url":"\u003cstring>","source":"\u003cstring>"}],"truncated":true,"shown_words":123,"total_words":123}],"images":[{"title":"\u003cstring>","link":"\u003cstring>","image":"\u003cstring>","source":"\u003cstring>","type":"image","thumbnail":"\u003cstring>","width":"\u003cstring>","height":"\u003cstring>"}],"news":[{"title":"\u003cstring>","link":"\u003cstring>","desc":"\u003cstring>","source":"\u003cstring>","type":"website","date":"\u003cstring>","dateModified":"\u003cstring>","image":"\u003cstring>","snippet":"\u003cstring>","answer":"\u003cstring>","extracts":["\u003cstring>"],"contentType":"\u003cstring>","reader":{},"contentSafety":{"rating":"safe","safeSearchApplied":true},"bang":"\u003cstring>","queryIndices":[123],"language":"\u003cstring>","site_country":"\u003cstring>","availability":{"state":"redirected","scope":"site","source":"probe","since":"2023-11-07T05:31:56Z","checkedAt":"2023-11-07T05:31:56Z","movedTo":"\u003cstring>"},"archive":[{"source":"\u003cstring>","url":"\u003cstring>","capturedAt":"2023-11-07T05:31:56Z"}],"seeAlso":[{"title":"\u003cstring>","url":"\u003cstring>","source":"\u003cstring>"}],"truncated":true,"shown_words":123,"total_words":123}],"citations":[{"title":"\u003cstring>","link":"\u003cstring>","desc":"\u003cstring>","source":"\u003cstring>","type":"website","date":"\u003cstring>","dateModified":"\u003cstring>","image":"\u003cstring>","snippet":"\u003cstring>","answer":"\u003cstring>","extracts":["\u003cstring>"],"contentType":"\u003cstring>","reader":{},"contentSafety":{"rating":"safe","safeSearchApplied":true},"bang":"\u003cstring>","queryIndices":[123],"language":"\u003cstring>","site_country":"\u003cstring>","availability":{"state":"redirected","scope":"site","source":"probe","since":"2023-11-07T05:31:56Z","checkedAt":"2023-11-07T05:31:56Z","movedTo":"\u003cstring>"},"archive":[{"source":"\u003cstring>","url":"\u003cstring>","capturedAt":"2023-11-07T05:31:56Z"}],"seeAlso":[{"title":"\u003cstring>","url":"\u003cstring>","source":"\u003cstring>"}],"truncated":true,"shown_words":123,"total_words":123}],"categories":[{"title":"\u003cstring>","link":"\u003cstring>","desc":"\u003cstring>","source":"\u003cstring>","type":"website","date":"\u003cstring>","dateModified":"\u003cstring>","image":"\u003cstring>","snippet":"\u003cstring>","answer":"\u003cstring>","extracts":["\u003cstring>"],"contentType":"\u003cstring>","reader":{},"contentSafety":{"rating":"safe","safeSearchApplied":true},"bang":"\u003cstring>","queryIndices":[123],"language":"\u003cstring>","site_country":"\u003cstring>","availability":{"state":"redirected","scope":"site","source":"probe","since":"2023-11-07T05:31:56Z","checkedAt":"2023-11-07T05:31:56Z","movedTo":"\u003cstring>"},"archive":[{"source":"\u003cstring>","url":"\u003cstring>","capturedAt":"2023-11-07T05:31:56Z"}],"seeAlso":[{"title":"\u003cstring>","url":"\u003cstring>","source":"\u003cstring>"}],"truncated":true,"shown_words":123,"total_words":123}],"places":[{"title":"\u003cstring>","link":"\u003cstring>","desc":"\u003cstring>","source":"\u003cstring>","type":"website","date":"\u003cstring>","dateModified":"\u003cstring>","image":"\u003cstring>","snippet":"\u003cstring>","answer":"\u003cstring>","extracts":["\u003cstring>"],"contentType":"\u003cstring>","reader":{},"contentSafety":{"rating":"safe","safeSearchApplied":true},"bang":"\u003cstring>","queryIndices":[123],"language":"\u003cstring>","site_country":"\u003cstring>","availability":{"state":"redirected","scope":"site","source":"probe","since":"2023-11-07T05:31:56Z","checkedAt":"2023-11-07T05:31:56Z","movedTo":"\u003cstring>"},"archive":[{"source":"\u003cstring>","url":"\u003cstring>","capturedAt":"2023-11-07T05:31:56Z"}],"seeAlso":[{"title":"\u003cstring>","url":"\u003cstring>","source":"\u003cstring>"}],"truncated":true,"shown_words":123,"total_words":123}],"profiles":[{"title":"\u003cstring>","link":"\u003cstring>","desc":"\u003cstring>","source":"\u003cstring>","type":"website","date":"\u003cstring>","dateModified":"\u003cstring>","image":"\u003cstring>","snippet":"\u003cstring>","answer":"\u003cstring>","extracts":["\u003cstring>"],"contentType":"\u003cstring>","reader":{},"contentSafety":{"rating":"safe","safeSearchApplied":true},"bang":"\u003cstring>","queryIndices":[123],"language":"\u003cstring>","site_country":"\u003cstring>","availability":{"state":"redirected","scope":"site","source":"probe","since":"2023-11-07T05:31:56Z","checkedAt":"2023-11-07T05:31:56Z","movedTo":"\u003cstring>"},"archive":[{"source":"\u003cstring>","url":"\u003cstring>","capturedAt":"2023-11-07T05:31:56Z"}],"seeAlso":[{"title":"\u003cstring>","url":"\u003cstring>","source":"\u003cstring>"}],"truncated":true,"shown_words":123,"total_words":123}],"social":[{"title":"\u003cstring>","link":"\u003cstring>","desc":"\u003cstring>","source":"\u003cstring>","type":"website","date":"\u003cstring>","dateModified":"\u003cstring>","image":"\u003cstring>","snippet":"\u003cstring>","answer":"\u003cstring>","extracts":["\u003cstring>"],"contentType":"\u003cstring>","reader":{},"contentSafety":{"rating":"safe","safeSearchApplied":true},"bang":"\u003cstring>","queryIndices":[123],"language":"\u003cstring>","site_country":"\u003cstring>","availability":{"state":"redirected","scope":"site","source":"probe","since":"2023-11-07T05:31:56Z","checkedAt":"2023-11-07T05:31:56Z","movedTo":"\u003cstring>"},"archive":[{"source":"\u003cstring>","url":"\u003cstring>","capturedAt":"2023-11-07T05:31:56Z"}],"seeAlso":[{"title":"\u003cstring>","url":"\u003cstring>","source":"\u003cstring>"}],"truncated":true,"shown_words":123,"total_words":123}],"academic":[{"title":"\u003cstring>","link":"\u003cstring>","desc":"\u003cstring>","source":"\u003cstring>","type":"website","date":"\u003cstring>","dateModified":"\u003cstring>","image":"\u003cstring>","snippet":"\u003cstring>","answer":"\u003cstring>","extracts":["\u003cstring>"],"contentType":"\u003cstring>","reader":{},"contentSafety":{"rating":"safe","safeSearchApplied":true},"bang":"\u003cstring>","queryIndices":[123],"language":"\u003cstring>","site_country":"\u003cstring>","availability":{"state":"redirected","scope":"site","source":"probe","since":"2023-11-07T05:31:56Z","checkedAt":"2023-11-07T05:31:56Z","movedTo":"\u003cstring>"},"archive":[{"source":"\u003cstring>","url":"\u003cstring>","capturedAt":"2023-11-07T05:31:56Z"}],"seeAlso":[{"title":"\u003cstring>","url":"\u003cstring>","source":"\u003cstring>"}],"truncated":true,"shown_words":123,"total_words":123}],"weather":{"location":{"name":"\u003cstring>","region":"\u003cstring>","country":"\u003cstring>","countryName":"\u003cstring>","coordinates":{"latitude":123,"longitude":123}},"temperature":123,"units":"metric","description":"\u003cstring>","feelsLike":123,"humidity":123,"windSpeed":123,"windDirection":123,"pressure":123,"icon":"\u003cstring>","cloudiness":123,"visibility":123,"weatherCode":123,"uvIndex":123,"timezone":"\u003cstring>","utcOffsetMinutes":123,"isDay":true,"sunrise":"\u003cstring>","sunset":"\u003cstring>","requested":{"day":"\u003cstring>","days":["\u003cstring>"],"label":"\u003cstring>","tonight":true},"forecast":[{"date":"\u003cstring>","high":123,"low":123,"weatherCode":123,"icon":"\u003cstring>","precipitationChance":123,"windSpeedMax":123,"sunrise":"\u003cstring>","sunset":"\u003cstring>"}],"available":"current","timestamp":123,"asOf":"\u003cstring>","source":{"name":"\u003cstring>","url":"\u003cstring>"},"hourly":[{"time":"\u003cstring>","temperature":123,"weatherCode":123,"icon":"\u003cstring>"}]},"calculation":{"expression":"\u003cstring>","result":"\u003cstring>","rawResult":"\u003cunknown>"},"preset":{"name":"app","from":"param","filled":["\u003cstring>"]},"warnings":["\u003cstring>"],"time":{"zone":"\u003cstring>","city":"\u003cstring>","country":"\u003cstring>","zoneName":"\u003cstring>","utcOffsetMinutes":123,"source":{"name":"\u003cstring>","url":"\u003cstring>"},"asOf":"\u003cstring>","stale":true},"currency":{"fromAmount":123,"fromCurrency":"\u003cstring>","toAmount":123,"toCurrency":"\u003cstring>","rate":123,"series":[123],"source":{"name":"\u003cstring>","url":"\u003cstring>"},"asOf":"\u003cstring>","stale":true},"translation":{"sourceText":"\u003cstring>","text":"\u003cstring>","from":"\u003cstring>","to":"\u003cstring>","fromCode":"\u003cstring>","toCode":"\u003cstring>","pronunciation":"\u003cstring>","method":"machine","source":{"name":"\u003cstring>","url":"\u003cstring>"},"asOf":"\u003cstring>","stale":true},"quote":{"symbol":"\u003cstring>","price":123,"name":"\u003cstring>","exchange":"\u003cstring>","currency":"\u003cstring>","change":123,"changePercent":123,"previousClose":123,"open":123,"low":123,"high":123,"marketState":"open","close":123,"extendedPrice":123,"extendedChange":123,"delayMinutes":123,"series":[123],"refresh":"\u003cstring>","source":{"name":"\u003cstring>","url":"\u003cstring>"},"asOf":"\u003cstring>","stale":true},"score":{"league":"\u003cstring>","status":"scheduled","teams":[{"name":"\u003cstring>","shortName":"\u003cstring>","logo":"\u003cstring>","score":123,"home":true}],"clock":"\u003cstring>","startTime":"\u003cstring>","events":["\u003cstring>"],"reason":"\u003cstring>","games":[{}],"refresh":"\u003cstring>","source":{"name":"\u003cstring>","url":"\u003cstring>"},"asOf":"\u003cstring>","stale":true}}}},"exampleType":"generated"},"text/markdown":{"schema":{"type":"string","description":"Markdown results with YAML frontmatter, returned when `format=context`.","uniqueKey":"","typeLabel":"string"},"examples":{"Example":{"title":"Example","value":"\u003cstring>"}},"exampleType":"generated"}},"exampleType":"generated"},"fdc9c827-78f1-4648-b646-a794331edf18":{"description":"Bad request — missing or invalid parameters","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Error type or message.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","description":"Detailed error description.","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["error","message"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"8fb648cf-6e0c-4313-8b77-2cc0f8f16234":{"description":"Unauthorized — missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Error type or message.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","description":"Detailed error description.","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["error","message"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"e427a9cb-7f72-4ac1-98b7-9359082f5813":{"description":"Insufficient credits — account balance depleted","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Error type or message.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","description":"Detailed error description.","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["error","message"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"dfe75424-2c02-4f85-ba6e-d0b7ea58ed1d":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Error type or message.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","description":"Detailed error description.","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["error","message"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"de0850a6-7f9b-4463-9f10-29c473a02368":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Error type or message.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","description":"Detailed error description.","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["error","message"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"7bd5246a-74fa-40af-970d-a3f0ce08bb16":{"apiKey":{"type":"apiKey","in":"header","name":"x-api-key","description":"API key from the [API Console](https://console.andiai.com).","scopes":[],"schemeName":"apiKey"}}},"servers":{"f4c490a4-487c-4a06-a011-49eb71d9c3f3":{"url":"https://api.andiai.com","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-api-key","description":"API key from the [API Console](https://console.andiai.com).","scopes":[],"schemeName":"apiKey"},"schema":{"title":"x-api-key","type":"string","description":"API key from the [API Console](https://console.andiai.com).","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"apiKey","name":"x-api-key"}],"title":"apiKey"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"andi-8668c890","siteName":"Andi AI Search API Docs","title":"Search the web (JSON body) - Andi AI Search API Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-22T01:06:26.513Z","originalFileLocation":"api-reference/search-the-web-json-body.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Same contract as GET /api/v1/search, but accepts parameters as a JSON body. Preferred for location-bearing requests because GET-style location encoding is awkward and keeps latitude/longitude out of HTTP access logs. All GET query parameters are accepted as body fields, plus optional location fields (latitude, longitude, accuracy, city, state, countryCode, postalCode, timezone, location).\">\u003cmeta data-mint-head name=\"application-name\" content=\"Andi AI Search API Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/andi-8668c890/a9jYpUWGmehXhSFH/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/andi-8668c890/a9jYpUWGmehXhSFH/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/andi-8668c890/a9jYpUWGmehXhSFH/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/andi-8668c890/a9jYpUWGmehXhSFH/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/andi-8668c890/a9jYpUWGmehXhSFH/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/andi-8668c890/a9jYpUWGmehXhSFH/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/andi-8668c890/a9jYpUWGmehXhSFH/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/andi-8668c890/a9jYpUWGmehXhSFH/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/andi-8668c890/a9jYpUWGmehXhSFH/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Search the web (JSON body) - Andi AI Search API Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Same contract as GET /api/v1/search, but accepts parameters as a JSON body. Preferred for location-bearing requests because GET-style location encoding is awkward and keeps latitude/longitude out of HTTP access logs. All GET query parameters are accepted as body fields, plus optional location fields (latitude, longitude, accuracy, city, state, countryCode, postalCode, timezone, location).\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Andi AI Search API Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.andiai.com/api-reference/search-the-web-json-body\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://andi-8668c890.mintlify.site/_mintlify/api/og/v2?division=API+Reference\u0026amp;title=Search+the+web+%28JSON+body%29\u0026amp;description=Same+contract+as+%60GET+%2Fapi%2Fv1%2Fsearch%60%2C+but+accepts+parameters+as+a+JSON+body.+Preferred+for+location-bearing+requests+because+GET-style+location+encoding+is+awk\u0026amp;theme=483769cda6f475d7eb1c521e\u0026amp;signature=7e1e9204bc8ebc17773786e2b82b49ecfa5eff2f853a8f9e8c344478ac73f5f9\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Search the web (JSON body) - Andi AI Search API Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Same contract as GET /api/v1/search, but accepts parameters as a JSON body. Preferred for location-bearing requests because GET-style location encoding is awkward and keeps latitude/longitude out of HTTP access logs. All GET query parameters are accepted as body fields, plus optional location fields (latitude, longitude, accuracy, city, state, countryCode, postalCode, timezone, location).\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://andi-8668c890.mintlify.site/_mintlify/api/og/v2?division=API+Reference\u0026amp;title=Search+the+web+%28JSON+body%29\u0026amp;description=Same+contract+as+%60GET+%2Fapi%2Fv1%2Fsearch%60%2C+but+accepts+parameters+as+a+JSON+body.+Preferred+for+location-bearing+requests+because+GET-style+location+encoding+is+awk\u0026amp;theme=483769cda6f475d7eb1c521e\u0026amp;signature=7e1e9204bc8ebc17773786e2b82b49ecfa5eff2f853a8f9e8c344478ac73f5f9\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/andi-8668c890/a9jYpUWGmehXhSFH/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Andi AI Search API Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#3B75FA\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.andiai.com/api-reference/search-the-web-json-body\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/search-the-web-json-body.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.andiai.com/#organization\",\"name\":\"Andi AI Search API Docs\",\"url\":\"https://docs.andiai.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/andi-8668c890/iAUOg-iw6vgsM_eb/logo/light.png?fit=max\u0026auto=format\u0026n=iAUOg-iw6vgsM_eb\u0026q=85\u0026s=214638eda335536c18a177e7535fbaf3\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.andiai.com#website\",\"name\":\"Andi AI Search API Docs\",\"url\":\"https://docs.andiai.com\",\"publisher\":{\"@id\":\"https://docs.andiai.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.andiai.com/api-reference/search-the-web-json-body#webpage\",\"url\":\"https://docs.andiai.com/api-reference/search-the-web-json-body\",\"name\":\"Search the web (JSON body)\",\"description\":\"Same contract as GET /api/v1/search, but accepts parameters as a JSON body. Preferred for location-bearing requests because GET-style location encoding is awkward and keeps latitude/longitude out of HTTP access logs. All GET query parameters are accepted as body fields, plus optional location fields (latitude, longitude, accuracy, city, state, countryCode, postalCode, timezone, location).\",\"dateModified\":\"2026-11-22T01:06:26.513Z\",\"isPartOf\":{\"@id\":\"https://docs.andiai.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.andiai.com/api-reference/search-the-web-json-body#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.andiai.com/api-reference/search-the-web-json-body#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints\",\"item\":\"https://docs.andiai.com/api-reference/search-the-web\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"API Reference\",\"item\":\"https://docs.andiai.com/api-reference/search-the-web\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Search the web (JSON body)\",\"item\":\"https://docs.andiai.com/api-reference/search-the-web-json-body\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.andiai.com/api-reference/search-the-web-json-body#apireference\",\"headline\":\"Search the web (JSON body)\",\"name\":\"Search the web (JSON body)\",\"description\":\"Same contract as GET /api/v1/search, but accepts parameters as a JSON body. Preferred for location-bearing requests because GET-style location encoding is awkward and keeps latitude/longitude out of HTTP access logs. All GET query parameters are accepted as body fields, plus optional location fields (latitude, longitude, accuracy, city, state, countryCode, postalCode, timezone, location).\",\"url\":\"https://docs.andiai.com/api-reference/search-the-web-json-body\",\"mainEntityOfPage\":{\"@id\":\"https://docs.andiai.com/api-reference/search-the-web-json-body#webpage\"},\"dateModified\":\"2026-11-22T01:06:26.513Z\",\"publisher\":{\"@id\":\"https://docs.andiai.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.andiai.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Andi AI Search API Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Andi AI Search API Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/search-the-web-json-body.md","siteName":"Andi AI Search API Docs","nav":{"global":{"anchors":[{"anchor":"AndiAI.com","icon":"globe","href":"https://andiai.com"},{"anchor":"API Console","icon":"terminal","href":"https://console.andiai.com"},{"anchor":"Andi Search","icon":"magnifying-glass","href":"https://andisearch.com"}]},"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":""}]},{"tab":"Examples","pages":[{"title":"Examples","href":"/examples/basic-search"}]},{"tab":"API reference","groups":[{"group":"Overview","pages":[{"title":"API reference","icon":"book","href":"/api-reference/introduction"}]},{"group":"Endpoints","pages":[{"group":"API Reference","pages":[{"title":"Search the web","description":"Performs a web search and returns structured results. Search effort is set automatically per query by default (`searchMode=auto`), with fixed modes (instant, low-cost, fast, balanced, deep, exhaustive) available for manual control. Supports domain and date filtering, query operators, and multiple output formats.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/search","href":"/api-reference/search-the-web"},{"title":"Search the web (JSON body)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/search","href":"/api-reference/search-the-web-json-body"},{"title":"Fetch a web page","description":"Fetches a single web page and returns clean extracted content (title, article text, metadata) as JSON, or LLM-ready markdown with format=context. The companion to /api/v1/search: search, pick a result, fetch it in full.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/fetch","href":"/api-reference/fetch-a-web-page"},{"title":"List news topics","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/news","href":"/api-reference/list-news-topics"},{"title":"Get a curated news feed","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/news/{topic}","href":"/api-reference/get-a-curated-news-feed"},{"title":"Refresh a live data block","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/data/refresh","href":"/api-reference/refresh-a-live-data-block"}]}]}]}]},"basePath":"","title":"Search the web (JSON body) - Andi AI Search API Docs","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CiUHMMOm.js","snippetPresets-BgfXU7Bw.js","utils-DWvOwgy_.js","style-to-object-BY3JEAdk.js","utils-BN7RXSMJ.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-CFw8bq89.js","conditional-requirements-CFM0id0Q.js","cloneDeep-CAwdfOU2.js","_Uint8Array-BJr8e-ZL.js","isObject-FP1Yky1u.js","ApiExamples-XX0UgMZK.js","usePlaygroundInputsStore-DXDFSa1V.js","shallow-CdX5aREi.js","isEqual-CoOaxexF.js","CodeSnippets-Cg2wpzWm.js","CodeSnippet-D_HwgQO_.js","getApiPlaygroundDisplay-CmCoerhe.js","Page-CVJ-f_k1.js","DynamicMarkdown-CQM9Bhbv.js","SectionHeading-DpbrP8nQ.js","icon-BPCgijHy.js","MethodPill-GQ8DuY0c.js","getPastedJson-Cb5mT31m.js","Check2Icon-a7bUI6e8.js","axios-CsQoIw0U.js","Markdown-CX2QY19L.js","AssistantPageLink-CY3bFglh.js","dist-Dl6_zDnT.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}