Returns a curated, ranked news feed for a fixed topic. The topic path segment selects the feed; an optional q filters it by keyword. results are ordered by relevance (a semantic pass tuned to the topic, weighted toward fresher articles); news holds the same articles in strict reverse-chronological order. images includes article images when available. When a pre-written brief exists for the topic it is returned in aiSummary (also in answer); a response to a q request carries no brief. Choose the output with format: json (default), context (markdown for LLMs), rss (RSS 2.0), embed (an HTML widget) or ticker (a scrolling headline bar). Links that cannot send a header, such as an <iframe> or a feed reader, use a feed key in the key query parameter with rss, embed or ticker. GET /api/v1/news lists the topics.
GET
/
api
/
v1
/
news
/
{topic}
Get a curated news feed
curl --request GET \ --url https://api.andiai.com/api/v1/news/{topic} \ --header 'x-api-key: <api-key>'
Number of results to return. Values outside 1–100 are clamped.
Required range: 1 <= x <= 100
format
enum<string>
default:json
Output format. json returns the response object. context returns markdown for language models (text/markdown), with the topic brief as a ## Summary block. rss returns an RSS 2.0 feed (application/rss+xml), with the brief in an andi:aiSummary element. embed returns a self-contained HTML widget (text/html). ticker returns a self-contained scrolling headline bar (text/html). Both can be loaded in an <iframe> with a feed key in the key parameter. A feed key works only with rss, embed and ticker. Any other value returns 400.
Available options:
json,
context,
rss,
embed,
ticker
q
string
Keyword filter within the topic, ranked against your query. Up to 200 characters. A response to a q request carries no brief (aiSummary is absent and answer is empty).
Maximum string length: 200
query
string
Alias of q.
Maximum string length: 200
hours
integer
default:48
Recency window in hours. Values outside 1–336 are clamped. Defaults to 48; format=ticker defaults to 24 unless q is set.
Required range: 1 <= x <= 336
since
string
Return only stories Andi first saw at or after this time: ISO 8601 or Unix seconds. To poll, send the time of your previous poll; a few stories near the boundary may repeat. Filters on when Andi first saw a story, not on its rank. Stories with no recorded first-seen time are kept. An invalid value is ignored with a warning.
lang
string
default:en
Language code (for example en, es), or all for every language. An unrecognised value falls back to en.
summary
boolean
default:true
Set to 0 or false to leave the topic brief out of this response (aiSummary is dropped and answer is empty).
detail
enum<string>
Set to full to get the topic's detailed brief. Only topics that list detail: ["full"] in GET /api/v1/news have one (currently startups and space); other topics return their standard brief.
Available options:
full
extracts
boolean
default:false
Include stored text passages from each article, in extracts[]. Defaults to true for format=context and when content=true; pass extracts=false to turn them off. Nothing is fetched live; the text comes from pages Andi has already stored.
content
boolean
default:false
Include each article's stored full text in reader.markdown. Also turns on extracts unless extracts=false is passed. Billed per token, as on search.
maxContentLength
integer
Maximum number of characters of reader.markdown to return per article. Only applies when content=true.
metadata
enum<string>
default:basic
Metadata level for format=context. basic is the default.
Available options:
basic,
full
title
string
format=embed only: heading shown in the widget. Up to 80 characters.
Maximum string length: 80
tz
string
format=embed only: IANA time zone for displayed times, for example America/New_York.
theme
enum<string>
default:light
format=ticker only: colour theme.
Available options:
light,
dark
speed
integer
default:60
format=ticker only: scroll speed, from 20 to 200.
Required range: 20 <= x <= 200
label
string
format=ticker only: short text shown on the ticker's label block.
key
string
A feed key, for links that cannot send a header (an <iframe>, a dashboard, a feed reader). Works only with format=rss, embed or ticker, and on GET /api/v1/news. Any other format, or no format, returns 403. A full API key in a URL returns 403: send it in the x-api-key header instead. Treat a feed-key link like a password.
noCache
boolean
default:false
Bypass the cache and fetch a fresh feed.
preset
enum<string>
Named defaults: app (ordinary defaults; direct calls) or agent (used by the MCP server and CLI; fills format=context, extracts=true and basic metadata). Any parameter you send wins.
Available options:
app,
agent
maxTokens
integer
Token budget for the articles (1,000 to 200,000), filled as on search: page content first, then extracts, then snippets.
Required range: 1000 <= x <= 200000
Response
Curated news feed in the requested format.
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":"control","enabled":true,"payload":{"type":"string","value":"control"},"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/get-a-curated-news-feed","slug":"/api-reference/get-a-curated-news-feed","pageMetadata":{"title":"Get a curated news feed","description":"Returns a curated, ranked news feed for a fixed topic. The topic path segment selects the feed; an optional `q` filters it by keyword. `results` are ordered by relevance (a semantic pass tuned to the topic, weighted toward fresher articles); `news` holds the same articles in strict reverse-chronological order. `images` includes article images when available. When a pre-written brief exists for the topic it is returned in `aiSummary` (also in `answer`); a response to a `q` request carries no brief. Choose the output with `format`: `json` (default), `context` (markdown for LLMs), `rss` (RSS 2.0), `embed` (an HTML widget) or `ticker` (a scrolling headline bar). Links that cannot send a header, such as an `\u003ciframe>` or a feed reader, use a feed key in the `key` query parameter with `rss`, `embed` or `ticker`. `GET /api/v1/news` lists the topics.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/news/{topic}","href":"/api-reference/get-a-curated-news-feed","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: [\"Returns a curated, ranked news feed for a fixed topic. The topic path segment selects the feed; an optional \", _jsx(_components.code, {\n children: \"q\"\n }), \" filters it by keyword. \", _jsx(_components.code, {\n children: \"results\"\n }), \" are ordered by relevance (a semantic pass tuned to the topic, weighted toward fresher articles); \", _jsx(_components.code, {\n children: \"news\"\n }), \" holds the same articles in strict reverse-chronological order. \", _jsx(_components.code, {\n children: \"images\"\n }), \" includes article images when available. When a pre-written brief exists for the topic it is returned in \", _jsx(_components.code, {\n children: \"aiSummary\"\n }), \" (also in \", _jsx(_components.code, {\n children: \"answer\"\n }), \"); a response to a \", _jsx(_components.code, {\n children: \"q\"\n }), \" request carries no brief. Choose the output with \", _jsx(_components.code, {\n children: \"format\"\n }), \": \", _jsx(_components.code, {\n children: \"json\"\n }), \" (default), \", _jsx(_components.code, {\n children: \"context\"\n }), \" (markdown for LLMs), \", _jsx(_components.code, {\n children: \"rss\"\n }), \" (RSS 2.0), \", _jsx(_components.code, {\n children: \"embed\"\n }), \" (an HTML widget) or \", _jsx(_components.code, {\n children: \"ticker\"\n }), \" (a scrolling headline bar). Links that cannot send a header, such as an \", _jsx(_components.code, {\n children: \"\u003ciframe>\"\n }), \" or a feed reader, use a feed key in the \", _jsx(_components.code, {\n children: \"key\"\n }), \" query parameter with \", _jsx(_components.code, {\n children: \"rss\"\n }), \", \", _jsx(_components.code, {\n children: \"embed\"\n }), \" or \", _jsx(_components.code, {\n children: \"ticker\"\n }), \". \", _jsx(_components.code, {\n children: \"GET /api/v1/news\"\n }), \" lists the topics.\"]\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":"Get a curated news feed","description":"Returns a curated, ranked news feed for a fixed topic. The topic path segment selects the feed; an optional `q` filters it by keyword. `results` are ordered by relevance (a semantic pass tuned to the topic, weighted toward fresher articles); `news` holds the same articles in strict reverse-chronological order. `images` includes article images when available. When a pre-written brief exists for the topic it is returned in `aiSummary` (also in `answer`); a response to a `q` request carries no brief. Choose the output with `format`: `json` (default), `context` (markdown for LLMs), `rss` (RSS 2.0), `embed` (an HTML widget) or `ticker` (a scrolling headline bar). Links that cannot send a header, such as an `\u003ciframe>` or a feed reader, use a feed key in the `key` query parameter with `rss`, `embed` or `ticker`. `GET /api/v1/news` lists the topics.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/news/{topic}","href":"/api-reference/get-a-curated-news-feed","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/andi-8668c890/0facf08817720e0f/organization-schema.js"],"openApiReferenceData":{"operation":{"operationId":"getNewsFeed","summary":"Get a curated news feed","description":"Returns a curated, ranked news feed for a fixed topic. The topic path segment selects the feed; an optional `q` filters it by keyword. `results` are ordered by relevance (a semantic pass tuned to the topic, weighted toward fresher articles); `news` holds the same articles in strict reverse-chronological order. `images` includes article images when available. When a pre-written brief exists for the topic it is returned in `aiSummary` (also in `answer`); a response to a `q` request carries no brief. Choose the output with `format`: `json` (default), `context` (markdown for LLMs), `rss` (RSS 2.0), `embed` (an HTML widget) or `ticker` (a scrolling headline bar). Links that cannot send a header, such as an `\u003ciframe>` or a feed reader, use a feed key in the `key` query parameter with `rss`, `embed` or `ticker`. `GET /api/v1/news` lists the topics.","parameters":["5f1ba6bf-b825-4a8a-b27f-2a5a16df4a7f","da844331-b0a2-48a6-97fc-0848101a61d0","840de5dd-31fd-49bb-8c0b-d83d3ac8124b","5b952c45-5c26-437a-ba97-4d41f644557d","8e3edddc-3c1e-4c41-9786-0e5a236a5a37","65d239a4-4f81-4fa7-aa9d-4f107a41c47d","3460293e-13c9-42e0-b2fa-bb5bb7e865d3","6b5205d8-6801-4de3-9a41-bf1ce3c38dd5","a5f3d295-ef69-44fd-8b03-a59ec7184a67","ebf78098-d240-4d0b-8d45-06c646563940","1709fdb5-9c9b-4468-9466-5966f937fe86","7cc354d9-b126-43cf-8c7f-876164fd630a","2b26677e-0591-468d-bb23-dc9c4654539e","62d66e11-6d3e-4785-aa93-3e581bcf144f","56641ecd-b294-47e0-a6c2-c5c29e9c2f9f","9af291f6-560f-4c32-b51c-527dda332d49","79f9e928-d0eb-4da3-a6ee-075068299ac1","5fcff90d-a70f-4264-9a87-c75cadaea546","8fbf664e-9d13-4f19-b8a1-535cd78f37f3","9d5a025f-21a4-42d8-aa80-87578c459a19","3b7669d6-b20a-4de0-bab4-3e2c07f40cd6","617b8571-c36f-4249-b1d3-20d02141afa7","cf08b9a2-6e6f-4034-ba44-33815263d9d3"],"responses":{"200":"261559cc-6b7f-4c9a-a907-bace2013f794","304":"cdd1c4ae-e665-47a0-9f22-dafef7c7de68","400":"b8af1fc7-42f1-4c27-8ae1-0c11457c4881","401":"7c29bfbc-2081-48a7-b82d-f8ea8d6c6070","402":"161ee56d-a75a-41d3-bbff-e0f446e79bf2","403":"06d165cd-5f8e-4ef9-b4e0-dcaabd80fa37","404":"4a1cd36a-27dd-46c7-95a8-f089046422c6","429":"de1aed74-6380-41b0-81be-b27b6c817664","502":"965f2403-df2f-4d83-b15a-6fb9bd773f26","503":"3d650953-30a7-4ec3-aa14-e69c5cdfedb3"},"method":"get","type":"path","servers":["f4c490a4-487c-4a06-a011-49eb71d9c3f3"],"security":["7bd5246a-74fa-40af-970d-a3f0ce08bb16"],"path":"/api/v1/news/{topic}","baseUrlOptions":["https://api.andiai.com"],"title":"Get a curated news feed","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"5f1ba6bf-b825-4a8a-b27f-2a5a16df4a7f":{"name":"topic","in":"path","required":true,"description":"Topic slug selecting the feed.","schema":{"type":"string","enum":["technology","business","finance","politics","sports","health","science","world","entertainment","us","europe","uk","asia","middle-east","africa","latin-america","australia","programming","startups","media","crypto","legal","space","top","hn-frontpage","ai-news","tech-news"],"isRequired":true,"description":"Topic slug selecting the feed.","uniqueKey":"","typeLabel":"enum\u003cstring>"}},"da844331-b0a2-48a6-97fc-0848101a61d0":{"name":"limit","in":"query","required":false,"description":"Number of results to return. Values outside 1–100 are clamped.","schema":{"type":"integer","minimum":1,"maximum":100,"default":20,"isRequired":false,"description":"Number of results to return. Values outside 1–100 are clamped.","uniqueKey":"","typeLabel":"integer"}},"840de5dd-31fd-49bb-8c0b-d83d3ac8124b":{"name":"format","in":"query","required":false,"description":"Output format. `json` returns the response object. `context` returns markdown for language models (`text/markdown`), with the topic brief as a `## Summary` block. `rss` returns an RSS 2.0 feed (`application/rss+xml`), with the brief in an `andi:aiSummary` element. `embed` returns a self-contained HTML widget (`text/html`). `ticker` returns a self-contained scrolling headline bar (`text/html`). Both can be loaded in an `\u003ciframe>` with a feed key in the `key` parameter. A feed key works only with `rss`, `embed` and `ticker`. Any other value returns `400`.","schema":{"type":"string","enum":["json","context","rss","embed","ticker"],"default":"json","isRequired":false,"description":"Output format. `json` returns the response object. `context` returns markdown for language models (`text/markdown`), with the topic brief as a `## Summary` block. `rss` returns an RSS 2.0 feed (`application/rss+xml`), with the brief in an `andi:aiSummary` element. `embed` returns a self-contained HTML widget (`text/html`). `ticker` returns a self-contained scrolling headline bar (`text/html`). Both can be loaded in an `\u003ciframe>` with a feed key in the `key` parameter. A feed key works only with `rss`, `embed` and `ticker`. Any other value returns `400`.","uniqueKey":"","typeLabel":"enum\u003cstring>"}},"5b952c45-5c26-437a-ba97-4d41f644557d":{"name":"q","in":"query","required":false,"description":"Keyword filter within the topic, ranked against your query. Up to 200 characters. A response to a `q` request carries no brief (`aiSummary` is absent and `answer` is empty).","schema":{"type":"string","maxLength":200,"isRequired":false,"description":"Keyword filter within the topic, ranked against your query. Up to 200 characters. A response to a `q` request carries no brief (`aiSummary` is absent and `answer` is empty).","uniqueKey":"","typeLabel":"string"}},"8e3edddc-3c1e-4c41-9786-0e5a236a5a37":{"name":"query","in":"query","required":false,"description":"Alias of `q`.","schema":{"type":"string","maxLength":200,"isRequired":false,"description":"Alias of `q`.","uniqueKey":"","typeLabel":"string"}},"65d239a4-4f81-4fa7-aa9d-4f107a41c47d":{"name":"hours","in":"query","required":false,"description":"Recency window in hours. Values outside 1–336 are clamped. Defaults to 48; `format=ticker` defaults to 24 unless `q` is set.","schema":{"type":"integer","minimum":1,"maximum":336,"default":48,"isRequired":false,"description":"Recency window in hours. Values outside 1–336 are clamped. Defaults to 48; `format=ticker` defaults to 24 unless `q` is set.","uniqueKey":"","typeLabel":"integer"}},"3460293e-13c9-42e0-b2fa-bb5bb7e865d3":{"name":"since","in":"query","required":false,"description":"Return only stories Andi first saw at or after this time: ISO 8601 or Unix seconds. To poll, send the time of your previous poll; a few stories near the boundary may repeat. Filters on when Andi first saw a story, not on its rank. Stories with no recorded first-seen time are kept. An invalid value is ignored with a warning.","schema":{"type":"string","isRequired":false,"description":"Return only stories Andi first saw at or after this time: ISO 8601 or Unix seconds. To poll, send the time of your previous poll; a few stories near the boundary may repeat. Filters on when Andi first saw a story, not on its rank. Stories with no recorded first-seen time are kept. An invalid value is ignored with a warning.","uniqueKey":"","typeLabel":"string"}},"6b5205d8-6801-4de3-9a41-bf1ce3c38dd5":{"name":"lang","in":"query","required":false,"description":"Language code (for example `en`, `es`), or `all` for every language. An unrecognised value falls back to `en`.","schema":{"type":"string","default":"en","isRequired":false,"description":"Language code (for example `en`, `es`), or `all` for every language. An unrecognised value falls back to `en`.","uniqueKey":"","typeLabel":"string"}},"a5f3d295-ef69-44fd-8b03-a59ec7184a67":{"name":"summary","in":"query","required":false,"description":"Set to `0` or `false` to leave the topic brief out of this response (`aiSummary` is dropped and `answer` is empty).","schema":{"type":"boolean","default":true,"isRequired":false,"description":"Set to `0` or `false` to leave the topic brief out of this response (`aiSummary` is dropped and `answer` is empty).","uniqueKey":"","typeLabel":"boolean"}},"ebf78098-d240-4d0b-8d45-06c646563940":{"name":"detail","in":"query","required":false,"description":"Set to `full` to get the topic's detailed brief. Only topics that list `detail: [\"full\"]` in `GET /api/v1/news` have one (currently `startups` and `space`); other topics return their standard brief.","schema":{"type":"string","enum":["full"],"isRequired":false,"description":"Set to `full` to get the topic's detailed brief. Only topics that list `detail: [\"full\"]` in `GET /api/v1/news` have one (currently `startups` and `space`); other topics return their standard brief.","uniqueKey":"","typeLabel":"enum\u003cstring>"}},"1709fdb5-9c9b-4468-9466-5966f937fe86":{"name":"extracts","in":"query","required":false,"description":"Include stored text passages from each article, in `extracts[]`. Defaults to `true` for `format=context` and when `content=true`; pass `extracts=false` to turn them off. Nothing is fetched live; the text comes from pages Andi has already stored.","schema":{"type":"boolean","default":false,"isRequired":false,"description":"Include stored text passages from each article, in `extracts[]`. Defaults to `true` for `format=context` and when `content=true`; pass `extracts=false` to turn them off. Nothing is fetched live; the text comes from pages Andi has already stored.","uniqueKey":"","typeLabel":"boolean"}},"7cc354d9-b126-43cf-8c7f-876164fd630a":{"name":"content","in":"query","required":false,"description":"Include each article's stored full text in `reader.markdown`. Also turns on `extracts` unless `extracts=false` is passed. Billed per token, as on search.","schema":{"type":"boolean","default":false,"isRequired":false,"description":"Include each article's stored full text in `reader.markdown`. Also turns on `extracts` unless `extracts=false` is passed. Billed per token, as on search.","uniqueKey":"","typeLabel":"boolean"}},"2b26677e-0591-468d-bb23-dc9c4654539e":{"name":"maxContentLength","in":"query","required":false,"description":"Maximum number of characters of `reader.markdown` to return per article. Only applies when `content=true`.","schema":{"type":"integer","isRequired":false,"description":"Maximum number of characters of `reader.markdown` to return per article. Only applies when `content=true`.","uniqueKey":"","typeLabel":"integer"}},"62d66e11-6d3e-4785-aa93-3e581bcf144f":{"name":"metadata","in":"query","required":false,"description":"Metadata level for `format=context`. `basic` is the default.","schema":{"type":"string","enum":["basic","full"],"default":"basic","isRequired":false,"description":"Metadata level for `format=context`. `basic` is the default.","uniqueKey":"","typeLabel":"enum\u003cstring>"}},"56641ecd-b294-47e0-a6c2-c5c29e9c2f9f":{"name":"title","in":"query","required":false,"description":"`format=embed` only: heading shown in the widget. Up to 80 characters.","schema":{"type":"string","maxLength":80,"isRequired":false,"description":"`format=embed` only: heading shown in the widget. Up to 80 characters.","uniqueKey":"","typeLabel":"string"}},"9af291f6-560f-4c32-b51c-527dda332d49":{"name":"tz","in":"query","required":false,"description":"`format=embed` only: IANA time zone for displayed times, for example `America/New_York`.","schema":{"type":"string","isRequired":false,"description":"`format=embed` only: IANA time zone for displayed times, for example `America/New_York`.","uniqueKey":"","typeLabel":"string"}},"79f9e928-d0eb-4da3-a6ee-075068299ac1":{"name":"theme","in":"query","required":false,"description":"`format=ticker` only: colour theme.","schema":{"type":"string","enum":["light","dark"],"default":"light","isRequired":false,"description":"`format=ticker` only: colour theme.","uniqueKey":"","typeLabel":"enum\u003cstring>"}},"5fcff90d-a70f-4264-9a87-c75cadaea546":{"name":"speed","in":"query","required":false,"description":"`format=ticker` only: scroll speed, from 20 to 200.","schema":{"type":"integer","minimum":20,"maximum":200,"default":60,"isRequired":false,"description":"`format=ticker` only: scroll speed, from 20 to 200.","uniqueKey":"","typeLabel":"integer"}},"8fbf664e-9d13-4f19-b8a1-535cd78f37f3":{"name":"label","in":"query","required":false,"description":"`format=ticker` only: short text shown on the ticker's label block.","schema":{"type":"string","isRequired":false,"description":"`format=ticker` only: short text shown on the ticker's label block.","uniqueKey":"","typeLabel":"string"}},"9d5a025f-21a4-42d8-aa80-87578c459a19":{"name":"key","in":"query","required":false,"description":"A feed key, for links that cannot send a header (an `\u003ciframe>`, a dashboard, a feed reader). Works only with `format=rss`, `embed` or `ticker`, and on `GET /api/v1/news`. Any other format, or no `format`, returns `403`. A full API key in a URL returns `403`: send it in the `x-api-key` header instead. Treat a feed-key link like a password.","schema":{"type":"string","isRequired":false,"description":"A feed key, for links that cannot send a header (an `\u003ciframe>`, a dashboard, a feed reader). Works only with `format=rss`, `embed` or `ticker`, and on `GET /api/v1/news`. Any other format, or no `format`, returns `403`. A full API key in a URL returns `403`: send it in the `x-api-key` header instead. Treat a feed-key link like a password.","uniqueKey":"","typeLabel":"string"}},"3b7669d6-b20a-4de0-bab4-3e2c07f40cd6":{"name":"noCache","in":"query","required":false,"description":"Bypass the cache and fetch a fresh feed.","schema":{"type":"boolean","default":false,"isRequired":false,"description":"Bypass the cache and fetch a fresh feed.","uniqueKey":"","typeLabel":"boolean"}},"617b8571-c36f-4249-b1d3-20d02141afa7":{"name":"preset","in":"query","required":false,"description":"Named defaults: `app` (ordinary defaults; direct calls) or `agent` (used by the MCP server and CLI; fills `format=context`, `extracts=true` and basic metadata). Any parameter you send wins.","schema":{"type":"string","enum":["app","agent"],"isRequired":false,"description":"Named defaults: `app` (ordinary defaults; direct calls) or `agent` (used by the MCP server and CLI; fills `format=context`, `extracts=true` and basic metadata). Any parameter you send wins.","uniqueKey":"","typeLabel":"enum\u003cstring>"}},"cf08b9a2-6e6f-4034-ba44-33815263d9d3":{"name":"maxTokens","in":"query","required":false,"description":"Token budget for the articles (1,000 to 200,000), filled as on search: page content first, then extracts, then snippets.","schema":{"type":"integer","minimum":1000,"maximum":200000,"isRequired":false,"description":"Token budget for the articles (1,000 to 200,000), filled as on search: page content first, then extracts, then snippets.","uniqueKey":"","typeLabel":"integer"}}},"responses":{"261559cc-6b7f-4c9a-a907-bace2013f794":{"description":"Curated news feed in the requested `format`.","headers":{"ETag":{"description":"Weak validator for the page. Not sent on replies that include page text (`extracts`, `content`).","schema":{"type":"string"}},"Last-Modified":{"description":"When the page was built. Not sent on replies that include page text.","schema":{"type":"string"}},"Age":{"description":"Age of the page in seconds.","schema":{"type":"integer"}}},"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 for language models (`format=context`).","uniqueKey":"","typeLabel":"string"},"examples":{"Example":{"title":"Example","value":"\u003cstring>"}},"exampleType":"generated"},"application/rss+xml":{"schema":{"type":"string","description":"RSS 2.0 feed (`format=rss`).","uniqueKey":"","typeLabel":"string"},"examples":{"Example":{"title":"Example","value":"\u003cstring>"}},"exampleType":"generated"},"text/html":{"schema":{"type":"string","description":"Self-contained HTML widget (`format=embed`) or scrolling ticker (`format=ticker`).","uniqueKey":"","typeLabel":"string"},"examples":{"Example":{"title":"Example","value":"\u003cstring>"}},"exampleType":"generated"}},"exampleType":"generated"},"cdd1c4ae-e665-47a0-9f22-dafef7c7de68":{"description":"The page has not changed since your `If-None-Match` or `If-Modified-Since` value. No body and no charge. Not sent for replies that include page text.","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"b8af1fc7-42f1-4c27-8ae1-0c11457c4881":{"description":"Invalid parameter: an unknown `format` or a `q` longer than 200 characters.","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"},"example":{"error":"Invalid parameter","message":"Invalid value for 'format'. Must be one of: json, context, rss, embed, ticker."},"examples":{"Example":{"title":"Example","value":{"error":"Invalid parameter","message":"Invalid value for 'format'. Must be one of: json, context, rss, embed, ticker."}}},"exampleType":"examples"}},"exampleType":"examples"},"7c29bfbc-2081-48a7-b82d-f8ea8d6c6070":{"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"},"example":{"error":"Unauthorized","message":"Invalid API key"},"examples":{"Example":{"title":"Example","value":{"error":"Unauthorized","message":"Invalid API key"}}},"exampleType":"examples"}},"exampleType":"examples"},"161ee56d-a75a-41d3-bbff-e0f446e79bf2":{"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"},"example":{"error":"Insufficient Credits","message":"Your account has insufficient credits. Please add credits to continue."},"examples":{"Example":{"title":"Example","value":{"error":"Insufficient Credits","message":"Your account has insufficient credits. Please add credits to continue."}}},"exampleType":"examples"}},"exampleType":"examples"},"06d165cd-5f8e-4ef9-b4e0-dcaabd80fa37":{"description":"Not allowed. Either a feed key was used for something it does not cover (another endpoint, `format=json` or `context`, or no `format`), or a full API key was put in the URL.","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":{"feedKey":{"title":"feedKey","summary":"Feed key used outside news feeds","value":{"error":"Feed key","message":"This key only works for news feeds (RSS, widget, ticker). Use a full API key for other endpoints."}},"keyInUrl":{"title":"keyInUrl","summary":"Full API key in the URL","value":{"error":"Key not allowed in URL","message":"A full API key must not be put in a link. Send it in the x-api-key header instead, or create a feed key in the API console (Keys → Create key → Feed key) for links."}}},"exampleType":"examples"}},"exampleType":"examples"},"4a1cd36a-27dd-46c7-95a8-f089046422c6":{"description":"Unknown topic. The response includes the full list of valid topic slugs.","content":{"application/json":{"schema":{"type":"object","required":["valid_topics","error","message"],"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"},"valid_topics":{"type":"array","description":"Every valid topic slug.","items":{"type":"string","uniqueKey":"valid_topics.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"valid_topics","typeLabel":"string[]"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":"Unknown topic","message":"No curated news feed exists for topic 'gardening'.","valid_topics":["technology","business","finance","politics","sports","health","science","world","entertainment","us","europe","uk","asia","middle-east","africa","latin-america","australia","programming","startups","media","crypto","legal","space","top","hn-frontpage","ai-news","tech-news"]},"examples":{"Example":{"title":"Example","value":{"error":"Unknown topic","message":"No curated news feed exists for topic 'gardening'.","valid_topics":["technology","business","finance","politics","sports","health","science","world","entertainment","us","europe","uk","asia","middle-east","africa","latin-america","australia","programming","startups","media","crypto","legal","space","top","hn-frontpage","ai-news","tech-news"]}}},"exampleType":"examples"}},"exampleType":"examples"},"de1aed74-6380-41b0-81be-b27b6c817664":{"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"},"example":{"error":"Too Many Requests","message":"Rate limit of N requests per second exceeded"},"examples":{"Example":{"title":"Example","value":{"error":"Too Many Requests","message":"Rate limit of N requests per second exceeded"}}},"exampleType":"examples"}},"exampleType":"examples"},"965f2403-df2f-4d83-b15a-6fb9bd773f26":{"description":"The `embed` or `ticker` widget could not be produced safely. Retry shortly or use another format. For these two formats the body is a short HTML message instead of JSON.","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"},"example":{"error":"Bad gateway","message":"The 'world' news feed is temporarily unavailable. Retry shortly."},"examples":{"Example":{"title":"Example","value":{"error":"Bad gateway","message":"The 'world' news feed is temporarily unavailable. Retry shortly."}}},"exampleType":"examples"}},"exampleType":"examples"},"3d650953-30a7-4ec3-aa14-e69c5cdfedb3":{"description":"The feed is temporarily unavailable. Retriable.","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"},"example":{"error":"Service unavailable","message":"The 'world' news feed is temporarily unavailable. Retry shortly."},"examples":{"Example":{"title":"Example","value":{"error":"Service unavailable","message":"The 'world' news feed is temporarily unavailable. Retry shortly."}}},"exampleType":"examples"}},"exampleType":"examples"}},"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":"Get a curated news feed - Andi AI Search API Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-22T01:06:26.567Z","originalFileLocation":"api-reference/get-a-curated-news-feed.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=\"Returns a curated, ranked news feed for a fixed topic. The topic path segment selects the feed; an optional q filters it by keyword. results are ordered by relevance (a semantic pass tuned to the topic, weighted toward fresher articles); news holds the same articles in strict reverse-chronological order. images includes article images when available. When a pre-written brief exists for the topic it is returned in aiSummary (also in answer); a response to a q request carries no brief. Choose the output with format: json (default), context (markdown for LLMs), rss (RSS 2.0), embed (an HTML widget) or ticker (a scrolling headline bar). Links that cannot send a header, such as an or a feed reader, use a feed key in the key query parameter with rss, embed or ticker. GET /api/v1/news lists the topics.\">\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=\"Get a curated news feed - Andi AI Search API Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Returns a curated, ranked news feed for a fixed topic. The topic path segment selects the feed; an optional q filters it by keyword. results are ordered by relevance (a semantic pass tuned to the topic, weighted toward fresher articles); news holds the same articles in strict reverse-chronological order. images includes article images when available. When a pre-written brief exists for the topic it is returned in aiSummary (also in answer); a response to a q request carries no brief. Choose the output with format: json (default), context (markdown for LLMs), rss (RSS 2.0), embed (an HTML widget) or ticker (a scrolling headline bar). Links that cannot send a header, such as an or a feed reader, use a feed key in the key query parameter with rss, embed or ticker. GET /api/v1/news lists the topics.\">\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/get-a-curated-news-feed\">\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=Get+a+curated+news+feed\u0026amp;description=Returns+a+curated%2C+ranked+news+feed+for+a+fixed+topic.+The+topic+path+segment+selects+the+feed%3B+an+optional+%60q%60+filters+it+by+keyword.+%60results%60+are+ordered+by+\u0026amp;theme=483769cda6f475d7eb1c521e\u0026amp;signature=a7779f89d86eec98d771538a7f51d02b001689d66e7fac045d58c9613bf3470f\">\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=\"Get a curated news feed - Andi AI Search API Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Returns a curated, ranked news feed for a fixed topic. The topic path segment selects the feed; an optional q filters it by keyword. results are ordered by relevance (a semantic pass tuned to the topic, weighted toward fresher articles); news holds the same articles in strict reverse-chronological order. images includes article images when available. When a pre-written brief exists for the topic it is returned in aiSummary (also in answer); a response to a q request carries no brief. Choose the output with format: json (default), context (markdown for LLMs), rss (RSS 2.0), embed (an HTML widget) or ticker (a scrolling headline bar). Links that cannot send a header, such as an or a feed reader, use a feed key in the key query parameter with rss, embed or ticker. GET /api/v1/news lists the topics.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://andi-8668c890.mintlify.site/_mintlify/api/og/v2?division=API+Reference\u0026amp;title=Get+a+curated+news+feed\u0026amp;description=Returns+a+curated%2C+ranked+news+feed+for+a+fixed+topic.+The+topic+path+segment+selects+the+feed%3B+an+optional+%60q%60+filters+it+by+keyword.+%60results%60+are+ordered+by+\u0026amp;theme=483769cda6f475d7eb1c521e\u0026amp;signature=a7779f89d86eec98d771538a7f51d02b001689d66e7fac045d58c9613bf3470f\">\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/get-a-curated-news-feed\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/get-a-curated-news-feed.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/get-a-curated-news-feed#webpage\",\"url\":\"https://docs.andiai.com/api-reference/get-a-curated-news-feed\",\"name\":\"Get a curated news feed\",\"description\":\"Returns a curated, ranked news feed for a fixed topic. The topic path segment selects the feed; an optional q filters it by keyword. results are ordered by relevance (a semantic pass tuned to the topic, weighted toward fresher articles); news holds the same articles in strict reverse-chronological order. images includes article images when available. When a pre-written brief exists for the topic it is returned in aiSummary (also in answer); a response to a q request carries no brief. Choose the output with format: json (default), context (markdown for LLMs), rss (RSS 2.0), embed (an HTML widget) or ticker (a scrolling headline bar). Links that cannot send a header, such as an or a feed reader, use a feed key in the key query parameter with rss, embed or ticker. GET /api/v1/news lists the topics.\",\"dateModified\":\"2026-11-22T01:06:26.567Z\",\"isPartOf\":{\"@id\":\"https://docs.andiai.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.andiai.com/api-reference/get-a-curated-news-feed#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.andiai.com/api-reference/get-a-curated-news-feed#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\":\"Get a curated news feed\",\"item\":\"https://docs.andiai.com/api-reference/get-a-curated-news-feed\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.andiai.com/api-reference/get-a-curated-news-feed#apireference\",\"headline\":\"Get a curated news feed\",\"name\":\"Get a curated news feed\",\"description\":\"Returns a curated, ranked news feed for a fixed topic. The topic path segment selects the feed; an optional q filters it by keyword. results are ordered by relevance (a semantic pass tuned to the topic, weighted toward fresher articles); news holds the same articles in strict reverse-chronological order. images includes article images when available. When a pre-written brief exists for the topic it is returned in aiSummary (also in answer); a response to a q request carries no brief. Choose the output with format: json (default), context (markdown for LLMs), rss (RSS 2.0), embed (an HTML widget) or ticker (a scrolling headline bar). Links that cannot send a header, such as an or a feed reader, use a feed key in the key query parameter with rss, embed or ticker. GET /api/v1/news lists the topics.\",\"url\":\"https://docs.andiai.com/api-reference/get-a-curated-news-feed\",\"mainEntityOfPage\":{\"@id\":\"https://docs.andiai.com/api-reference/get-a-curated-news-feed#webpage\"},\"dateModified\":\"2026-11-22T01:06:26.567Z\",\"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/get-a-curated-news-feed.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","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","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/fetch","href":"/api-reference/fetch-a-web-page"},{"title":"List news topics","description":"Lists every topic available at `GET /api/v1/news/{topic}` with its title, category, supported formats, whether a detailed brief is available and its recent story count. Requires an API key; not billed. A feed key can be sent in the `key` query parameter. Add `format=html` for a page of ready links.","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","description":"Returns only the latest figure for one live `quote` or `score` block, without running a search. Use the block's `refresh` value as `ref`. Call it at most once a minute: calls within a minute share one copy.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/data/refresh","href":"/api-reference/refresh-a-live-data-block"}]}]}]}]},"basePath":"","title":"Get a curated news feed - 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"]}