removedInput schema / properties / count
Removed value: -{
- "default": 10,
- "description": "Maximum number of results to return per source (1-20).",
- "maximum": 20,
- "minimum": 1,
- "type": "integer"
-}
removedInput schema / properties / country_code / default
Removed value: -"US"
changedInput schema / properties / country_code / description
Previous value: -"ISO country code for localized results."New value: +"ISO 3166-1 alpha-2 country code for localized results. Omit it and the server uses US. Set it to localize for the user."
removedInput schema / properties / effort
Removed value: -{
- "description": "Search effort: \"fast\" (default) or \"instant\" (fastest, serves cached embeds as-is). Omit for fast.",
- "enum": [
- "fast",
- "instant"
- ],
- "type": "string"
-}
removedInput schema / properties / include_contents
Removed value: -{
- "default": true,
- "description": "Inline each Tako card's data preview (default true; preview_rows sets how many rows). Set false — pointers-only, no rows — for large parallel fan-outs or when coverage is unconfirmed (no prior tako_available_data check). DATA source only; web page text is never auto-inlined (billed per page — use tako_contents). Full export is a separate tako_contents call, only for cards marked `exportable: true`.",
- "type": "boolean"
-}
removedInput schema / properties / locale / default
Removed value: -"en-US"
changedInput schema / properties / locale / description
Previous value: -"Locale for results."New value: +"BCP-47 locale tag for language and formatting. Omit it and the server uses en-US. Set it to localize for the user."
removedInput schema / properties / node_ids
Removed value: -{
- "description": "Graph node ids (from tako_available_data, or a card's nodes) to PIN into the proprietary data source. Pinned nodes get a strong retrieval boost. Max 20. Applies only to the 'data' source.",
- "items": {
- "type": "string"
- },
- "maxItems": 20,
- "type": "array"
-}
removedInput schema / properties / preview_rows
Removed value: -{
- "default": 20,
- "description": "Cap on the rows of each card's data inlined when include_contents is true — always the N MOST-RECENT rows (default 20, the free inline allowance the server ships; values above your account's allowance have no effect). Lower it to trim context on broad fan-outs. For MORE than 20 rows, call tako_contents on the card's url (max_rows up to 2,000 — first 20 free, priced beyond). Ignored when include_contents is false.",
- "maximum": 250,
- "minimum": 1,
- "type": "integer"
-}
changedInput schema / properties / query / description
Previous value: -"Natural-language search query (e.g. \"US GDP growth\", \"Intel vs Nvidia revenue\"). Website-traffic data is keyed by domain — query \"openai.com monthly visits\", not \"OpenAI website visits\"."New value: +"Natural-language search query (e.g. \"US GDP growth\", \"Intel vs Nvidia revenue\"). Double-quote a multi-word name to keep it one entity (\"tesla motors\" club revenue); an unpaired quote disables quoting. Website-traffic data is keyed by domain — query \"openai.com monthly visits\", not \"OpenAI website visits\"."
changedInput schema / properties / sources / description
Previous value: -"Source(s) to search. Default [\"data\",\"web\"] (both) — keep BOTH enabled unless you have a confirmed reason to narrow. Narrow to [\"data\"] only once `tako_available_data` has confirmed the proprietary data exists (web is the fallback when it does not). Narrow to [\"web\"] only for content a data graph cannot hold (news articles, page text, qualitative claims) — never because a metric merely feels web-native: website traffic, app usage, and similar digital metrics ARE in the proprietary data graph. (\"tako\" is a legacy synonym for \"data\".)"New value: +"Which corpora to search; default is both. Narrow to [\"data\"] once `tako_available_data` confirms coverage; narrow to [\"web\"] only for news or page text — website traffic is in the data graph."
changedInput schema / properties / sources / items / enum
Previous value: -[
- "data",
- "web",
- "tako"
-]New value: +[
+ "data",
+ "web"
+]
removedInput schema / properties / strict
Removed value: -{
- "default": false,
- "description": "Hard filter. When true, return ONLY cards matching at least one node in node_ids (which must then be non-empty — empty node_ids + strict is a 400). When false (default), pinned nodes are preferred/boosted but organic results still return.",
- "type": "boolean"
-}
changedOutput schema / properties / cards / description
Previous value: -"The data cards — the payload. Each carries its title, description (headline value), facts, and inline rows under `content`."New value: +"The data cards. Fetch an exportable card's rows with tako_contents on its url."
addedOutput schema / properties / cards / items / properties / coverage_end
Added value: +{
+ "description": "Where the DATA ends — use this, not `last_updated`, to judge whether a figure is current. Reduced ISO precision at the series' own granularity (\"2026\", \"2026-06\", \"2026-06-30\"), and it can be in the future on a card with projections.",
+ "type": "string"
+}
addedOutput schema / properties / cards / items / properties / description
Added value: +{
+ "description": "Headline value and range — often the answer itself.",
+ "type": "string"
+}
addedOutput schema / properties / cards / items / properties / exportable
Added value: +{
+ "description": "true → tako_contents on `url` returns the rows; false → rows are locked, read the headline from `description`.",
+ "type": "boolean"
+}
addedOutput schema / properties / cards / items / properties / last_updated
Added value: +{
+ "description": "Date Tako last refreshed this card — NOT where its data ends.",
+ "type": "string"
+}
addedOutput schema / properties / cards / items / properties / nodes
Added value: +{
+ "description": "Graph handles — pass ids to tako_graph_related.",
+ "items": {
+ "additionalProperties": {},
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "name",
+ "type"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+}
addedOutput schema / properties / cards / items / properties / relevance
Added value: +{
+ "description": "Either a 1.0-5.0 score as a string (\"4.5\", 5.0 = exact match) on entitled accounts, or a coarse word (\"High\"). Higher is more relevant in both forms.",
+ "type": "string"
+}
addedOutput schema / properties / cards / items / properties / source
Added value: +{
+ "type": "string"
+}
addedOutput schema / properties / cards / items / properties / title
Added value: +{
+ "type": "string"
+}
addedOutput schema / properties / cards / items / properties / total_rows
Added value: +{
+ "description": "Rows behind `url` (exportable cards only).",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+}
addedOutput schema / properties / cards / items / properties / url
Added value: +{
+ "description": "The card page — the tako_contents handle.",
+ "type": "string"
+}
addedOutput schema / properties / cards / items / required
Added value: +[
+ "exportable"
+]
removedOutput schema / properties / dark_mode
Removed value: -{
- "type": "boolean"
-}
removedOutput schema / properties / embed_url
Removed value: -{
- "pattern": "^https?:\\/\\/",
- "type": "string"
-}
changedOutput schema / properties / guidance / description
Previous value: -"Present only on a zero-card response: the recovery protocol."New value: +"Zero-card responses only: what this response is evidence about, and the one next action."
removedOutput schema / properties / height
Removed value: -{
- "exclusiveMinimum": 0,
- "maximum": 9007199254740991,
- "type": "integer"
-}
removedOutput schema / properties / image_url
Removed value: -{
- "pattern": "^https?:\\/\\/",
- "type": "string"
-}
addedOutput schema / properties / metric_definitions
Added value: +{
+ "additionalProperties": {
+ "type": "string"
+ },
+ "description": "What each metric means (unit, basis, caveats), keyed by metric name, deduped across cards.",
+ "propertyNames": {
+ "type": "string"
+ },
+ "type": "object"
+}
removedOutput schema / properties / pub_id
Removed value: -{
- "type": "string"
-}
addedOutput schema / properties / source_notes
Added value: +{
+ "additionalProperties": {
+ "type": "string"
+ },
+ "description": "What each source is and how it builds its data, keyed by source name.",
+ "propertyNames": {
+ "type": "string"
+ },
+ "type": "object"
+}
changedOutput schema / properties / web_results / description
Previous value: -"Web results, each with a `snippet`. A snippet is the passages selected against your query, not the page's opening text, so it usually carries the answer-bearing sentence. A ' … ' inside one marks a discontinuity — either passages joined from different parts of the page, or the page's own ellipsis — so read it as a whole and never quote across it as one continuous sentence. `null` means that page had no relevant passage — its url is still fetchable via tako_contents."New value: +"Web results."
addedOutput schema / properties / web_results / items / properties / content
Added value: +{
+ "additionalProperties": {},
+ "description": "Page text — only when the request asked for it.",
+ "properties": {},
+ "type": "object"
+}
addedOutput schema / properties / web_results / items / properties / published
Added value: +{
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "type": "null"
+ }
+ ]
+}
addedOutput schema / properties / web_results / items / properties / snippet
Added value: +{
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Passages selected against the query. A ' … ' marks a discontinuity — joined passages or the page's own ellipsis — so never quote across it as one sentence. null → no relevant passage, url still fetchable."
+}
addedOutput schema / properties / web_results / items / properties / source
Added value: +{
+ "type": "string"
+}
addedOutput schema / properties / web_results / items / properties / title
Added value: +{
+ "type": "string"
+}
addedOutput schema / properties / web_results / items / properties / url
Added value: +{
+ "type": "string"
+}
addedOutput schema / properties / web_results / items / required
Added value: +[
+ "url"
+]
removedOutput schema / properties / width
Removed value: -{
- "exclusiveMinimum": 0,
- "maximum": 9007199254740991,
- "type": "integer"
-}
changedOutput schema / required
Previous value: -[
- "usage"
-]New value: +[
+ "cards",
+ "web_results",
+ "usage"
+]