Previous 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."New value: +"Which corpora to search; default is both. Narrow to [\"web\"] only for news or page text — website traffic is in the data graph."

Previous value: -"Zero-card verdict and next action, or how a keyless caller unlocks a placeholder card."New value: +"How a keyless caller unlocks a placeholder card."

Previous value: -"Zero-card responses only: what this response is evidence about, and the one next action."New value: +"Zero-card verdict and next action, or how a keyless caller unlocks a placeholder card."

Removed value: -{
-  "default": 10,
-  "description": "Maximum number of results to return per source (1-20).",
-  "maximum": 20,
-  "minimum": 1,
-  "type": "integer"
-}

Removed value: -"US"

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."

Removed value: -{
-  "description": "Search effort: \"fast\" (default) or \"instant\" (fastest, serves cached embeds as-is). Omit for fast.",
-  "enum": [
-    "fast",
-    "instant"
-  ],
-  "type": "string"
-}

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"
-}

Removed value: -"en-US"

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."

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"
-}

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"
-}

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\"."

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."

Previous value: -[
-  "data",
-  "web",
-  "tako"
-]New value: +[
+  "data",
+  "web"
+]

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"
-}

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."

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"
+}

Added value: +{
+  "description": "Headline value and range — often the answer itself.",
+  "type": "string"
+}

Added value: +{
+  "description": "true → tako_contents on `url` returns the rows; false → rows are locked, read the headline from `description`.",
+  "type": "boolean"
+}

Added value: +{
+  "description": "Date Tako last refreshed this card — NOT where its data ends.",
+  "type": "string"
+}

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"
+}

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"
+}

Added value: +{
+  "type": "string"
+}

Added value: +{
+  "type": "string"
+}

Added value: +{
+  "description": "Rows behind `url` (exportable cards only).",
+  "maximum": 9007199254740991,
+  "minimum": -9007199254740991,
+  "type": "integer"
+}

Added value: +{
+  "description": "The card page — the tako_contents handle.",
+  "type": "string"
+}

Added value: +[
+  "exportable"
+]

Removed value: -{
-  "type": "boolean"
-}

Removed value: -{
-  "pattern": "^https?:\\/\\/",
-  "type": "string"
-}

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."

Removed value: -{
-  "exclusiveMinimum": 0,
-  "maximum": 9007199254740991,
-  "type": "integer"
-}

Removed value: -{
-  "pattern": "^https?:\\/\\/",
-  "type": "string"
-}

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"
+}

Removed value: -{
-  "type": "string"
-}

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"
+}

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."

Added value: +{
+  "additionalProperties": {},
+  "description": "Page text — only when the request asked for it.",
+  "properties": {},
+  "type": "object"
+}

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}

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."
+}

Added value: +{
+  "type": "string"
+}

Added value: +{
+  "type": "string"
+}

Added value: +{
+  "type": "string"
+}

Added value: +[
+  "url"
+]

Removed value: -{
-  "exclusiveMinimum": 0,
-  "maximum": 9007199254740991,
-  "type": "integer"
-}

Previous value: -[
-  "usage"
-]New value: +[
+  "cards",
+  "web_results",
+  "usage"
+]

Removed value: -{
-  "type": "string"
-}

Previous value: -[
-  "request_id",
-  "usage"
-]New value: +[
+  "usage"
+]

Previous value: -"Web results with their snippets."New 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."

Previous value: -[
-  {
-    "additionalProperties": {},
-    "properties": {
-      "compute": {
-        "anyOf": [
-          {
-            "additionalProperties": {},
-            "properties": {
-              "cost_usd": {
-                "type": "number"
-              }
-            },
-            "required": [
-              "cost_usd"
-            ],
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "data": {
-        "anyOf": [
-          {
-            "additionalProperties": {},
-            "properties": {
-              "cost_usd": {
-                "type": "number"
-              },
-              "datasets": {
-                "maximum": 9007199254740991,
-                "minimum": -9007199254740991,
-                "type": "integer"
-              }
-            },
-            "required": [
-              "cost_usd",
-              "datasets"
-            ],
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "total_cost_usd": {
-        "type": "number"
-      }
-    },
-    "required": [
-      "total_cost_usd"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": {},
+    "properties": {
+      "total_cost_usd": {
+        "type": "number"
+      }
+    },
+    "required": [
+      "total_cost_usd"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

Added value: +{
+  "description": "The data cards — the payload. Each carries its title, description (headline value), facts, and inline rows under `content`.",
+  "items": {
+    "additionalProperties": {},
+    "properties": {},
+    "type": "object"
+  },
+  "type": "array"
+}

Added value: +{
+  "description": "Web results with their snippets.",
+  "items": {
+    "additionalProperties": {},
+    "properties": {},
+    "type": "object"
+  },
+  "type": "array"
+}

Previous value: -"Inline each Tako card's free 5-row data preview (default true). Set false for pointers-only (title/chart/nodes, no rows) — cheaper for large parallel fan-outs. Controls the DATA source only; web page text is never auto-inlined (billed per page — use tako_contents). Full export is a separate tako_contents call — possible only for cards marked `exportable: true`."New value: +"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`."

Added 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"
+}

Removed value: -{
-  "items": {
-    "additionalProperties": {},
-    "properties": {
-      "card_id": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "content": {
-        "anyOf": [
-          {
-            "additionalProperties": {},
-            "properties": {
-              "content_format": {
-                "anyOf": [
-                  {
-                    "type": "string"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ]
-              },
-              "cost": {
-                "anyOf": [
-                  {
-                    "type": "number"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ]
-              },
-              "data": {
-                "anyOf": [
-                  {
-                    "type": "string"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ]
-              },
-              "total_rows": {
-                "anyOf": [
-                  {
-                    "type": "number"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ]
-              },
-              "truncated": {
-                "anyOf": [
-                  {
-                    "type": "boolean"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ]
-              }
-            },
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Raw export descriptor + inline data preview. Read the sibling `exportable` boolean as the call/skip signal instead of inferring from this field's presence. Missing or null here is equivalent to exportable:false. Present is necessary for a tako_contents export but not a guarantee (a rare card still 403s — fall back to the preview/chart)."
-      },
-      "description": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "embed_url": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "exportable": {
-        "description": "Whether this card's underlying data can be fetched with tako_contents. false → NOT exportable: do NOT call tako_contents on this card, use its inline preview/chart. true → eligible, but not a guarantee — a rare card still 403s, so on error fall back rather than retry.",
-        "type": "boolean"
-      },
-      "image_url": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "nodes": {
-        "anyOf": [
-          {
-            "items": {
-              "additionalProperties": false,
-              "properties": {
-                "id": {
-                  "type": "string"
-                },
-                "name": {
-                  "type": "string"
-                },
-                "type": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "id",
-                "name",
-                "type"
-              ],
-              "type": "object"
-            },
-            "type": "array"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "title": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "webpage_url": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      }
-    },
-    "type": "object"
-  },
-  "type": "array"
-}

Added value: +"Present only on a zero-card response: the recovery protocol."

Added value: +"Cost-plus usage for this request (null when not metered)."

Removed value: -{
-  "items": {
-    "additionalProperties": {},
-    "properties": {
-      "citation_number": {
-        "anyOf": [
-          {
-            "type": "number"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "content": {
-        "anyOf": [
-          {
-            "additionalProperties": {},
-            "properties": {
-              "content_format": {
-                "anyOf": [
-                  {
-                    "type": "string"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ]
-              },
-              "cost": {
-                "anyOf": [
-                  {
-                    "type": "number"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ]
-              },
-              "data": {
-                "anyOf": [
-                  {
-                    "type": "string"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ]
-              },
-              "total_rows": {
-                "anyOf": [
-                  {
-                    "type": "number"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ]
-              },
-              "truncated": {
-                "anyOf": [
-                  {
-                    "type": "boolean"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ]
-              }
-            },
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "publish_date": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "snippet": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "source_name": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "title": {
-        "type": "string"
-      },
-      "url": {
-        "description": "The web page URL. Always fetchable via tako_contents for the page's full text (web urls need no `exportable` flag, unlike cards) — a fallback you can read when no Tako data card fits the query.",
-        "type": "string"
-      }
-    },
-    "required": [
-      "title",
-      "url"
-    ],
-    "type": "object"
-  },
-  "type": "array"
-}

Previous value: -[
-  "cards",
-  "web_results",
-  "usage",
-  "request_id"
-]New value: +[
+  "request_id",
+  "usage"
+]