Tako: Fetch Contents
tako_contentsRead-onlyIdempotent
Fetch the full content behind a url: a web page's text, or an exportable Tako card's data rows. Batch up to 10 urls in one call — each one is billed and fails on its own.
Fetch only cards that tako_search marked exportable: true. Rows bill per 1,000 delivered, so set max_rows when the recent rows are enough. If a page is long, such as a filing or an annual report, set query to get back only the passages that match.
Best for: reading one source in full — a page you need to quote, or the rows behind a card you need to compute over.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| urls | Yes | The urls to fetch: a Tako card url or a web result url. One call for 8 urls costs the same as 8 separate calls and saves 7 round trips. | |
| query | No | Web pages only: return the passages around matches of this phrase instead of the whole page. The full page is always scanned, so no match means the phrase isn't there. | |
| max_rows | No | Tako cards only: how many rows to return. Omit it for the whole card, up to 2,000 rows. Every row delivered is billed, so lower it when the recent rows are enough. | |
| max_chars | No | Web pages only: character cap on the extracted text. Inline fetches default to 100,000 per url, less across a batch. Raise it for a long document; `truncated` reports a cut. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| usage | Yes | What this request cost. | |
| results | Yes | One per requested url, in order. |