Tako tako API
The tako API from Tako — 7 operation(s) for tako.
Tako tako API is one of 2 APIs that Tako publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
Tagged areas include tako. The published artifact set on APIs.io includes an OpenAPI specification and authentication docs.
This API exposes 7 operations across 7 paths, and defines 46 schemas. It is described by OpenAPI 3.1.0, at version 1.0.0.
Requests are made against a single base URL, https://tako.com/api/.
7 operations
7 paths
46 schemas
3 GET4 POST
Metadata
The identity and technical contract details declared by the specification.
Authentication & Security 1
Tako tako API declares
1 security scheme
for authenticating requests.
An API key is passed in the header as X-API-Key (apiKey).
Paths & Operations 7
Across 7 paths, the API surfaces 7 operations — 3 GET, 4 POST. Each is listed below with its method, path, parameters, and response codes.
tako 7
POST
/v3/search
Search
POST
/v1/answer
Answer
GET
/beta/graph/search
Search the data graph
GET
/beta/graph/related
Get a graph node's related nodes
GET
/beta/graph/node/{id}
Get a graph node by id
POST
/v1/contents
Download content
POST
/v1/thin_viz/create/
Create a visualization card directly from component configurations. Supported component types: header, generictimeseries, categoricalbar, stockboxes, financialboxes, table.
Schemas 46
The contract defines 46 schemas that model the data the API accepts and returns. The most detailed are TakoCard (17 properties), ContentItem (11 properties), ResultContent (10 properties), ThinVizCard (9 properties). Each schema is shown below with its type and property counts.
KnowledgeCardMethodology
object
2 properties
2 required
ContentsFormat
string
Serialization of tabular (Tako card) data. Web content is always raw text and carries no content format (contentformat is null).
WebResult
object
A single raw web search result from the WEB source index. Distinct from KnowledgeCardSource (a citation inside a synthesized answer) and KnowledgeCard (a Tako…
7 properties
2 required
DataSourceSettings
object
Tako data (card) source settings. It adds the two contents-export fields on top of the base count and includecontents. Web sources use the base SourceSettings:…
6 properties
CreateCardRequest
object
Request model for creating a card directly with components.
8 properties
1 required
AnswerResponse
object
Response for POST /api/v1/answer: the synthesized answer plus the retrieval behind it.
5 properties
2 required
ExportPricing
object
Card-CSV export pricing RATE, published so a caller can compute an export's cost before fetching. Full charge = baselineusd + rowcpmusd max(0, rows - freerows)…
4 properties
4 required
SourceSettings
object
2 properties
GraphNodeType
string
TakoDatasetColumn
object
Typed header entry; type is the JSON-facing column type.
2 properties
2 required
ContentsRequest
object
Request body for POST /api/v1/contents. The caller passes the result URL it wants downloadable content for, and the endpoint detects the right content from the…
5 properties
1 required
GraphSearchResponse
object
2 properties
1 required
GraphRelationPage
object
7 properties
5 required
SearchEffortLevel
string
Public effort taxonomy for search and answer. FAST is the default. INSTANT serves cached embeds without a new data retrieval and works in all environments. DEE…
RelationKind
string
How Tako derived a relation group.
UsageData
object
The cost and quantity of inline data delivered in the response: the agent per-dataset surcharge, the search and answer includecontents charge, or the contents…
2 properties
2 required
TakoCardSource
object
A source that backs a TakoCard on the SDK surfaces. It uses the {data, web} TakoSourceIndex taxonomy.
5 properties
1 required
Usage
object
Usage for one metered request. totalcostusd is always present (the total quoted charge). compute and data are the additive breakdown; each appears only where i…
3 properties
1 required
UsageCompute
object
The cost of running the operation. Absent on surfaces with no compute step (contents).
1 property
1 required
TakoDatasetColumnType
string
Logical column type declared in a TakoDataset header. Temporal cells are ISO-8601 strings. Each column declares 'date' or 'datetime' on its own: a temporal col…
Sources
object
Per-source settings. The search includes an index only if its field is present. The Tako data source is named data. Tako still accepts the legacy key tako as a…
2 properties
SearchResponse
object
4 properties
1 required
SearchRequest
object
7 properties
1 required
TakoDatasetSource
object
Per-dataset provenance entry. index names the source index, not a citation display number. It is "data" for every dataset today — web content never fills a dat…
2 properties
1 required
ComponentConfig
object
Configuration for a single component in a card.
3 properties
2 required
NerLabel
string
OutputSettings
object
2 properties
APIErrorType
string
ComponentTypeEnum
string
Component types supported for thin viz schemas with builder support. These component types have dedicated builders that process configurations, add defaults, a…
TakoDataset
object
The dataset-slot envelope: exact retrieved rows as positional arrays in columns order. The rows come directly from the data source; the LLM never transcribes t…
7 properties
6 required
ThinVizCard
object
Response for POST /api/v1/thinviz/create — a created visualization card. Distinct from KnowledgeCard: thinviz builds a self-contained chart from a caller-suppl…
9 properties
TakoSourceIndex
string
Public source taxonomy for the SDK card surfaces (v3 search, v1 answer, agent). It is symmetric with the request taxonomy {data, web}.
GraphRelation
object
6 properties
5 required
GraphRelatedResponse
object
4 properties
1 required
TakoCard
object
A Tako knowledge card on the search and answer surfaces. It carries a content download descriptor.
17 properties
BaseAPIError
object
2 properties
2 required
DataFreshness
object
When the card's data was last observed and last refreshed. Either field may be null when that date isn't available for the card type.
2 properties
ResultContent
object
Describes the downloadable content behind a result. Pricing: for a Tako card CSV export, the charge is a flat per-export baseline plus a per-source, per-row CP…
10 properties
MetricDefinition
object
Definition of a metric shown on a card. Sourced from the metric's ValueType definition — the same text as the in-app methodology 'Metrics' tab.
2 properties
2 required
EntityClassName
string
GraphNode
object
7 properties
3 required
KnowledgeCardRelevance
string
ContentItem
object
A single downloadable artifact. It inherits contentformat, cost, the payload fields (data, records, dataset, totalrows, truncated), and the presigned url and e…
11 properties
1 required
ContentsDeliveryMode
string
How contents reach the caller. URL returns a short-lived presigned file download; INLINE returns the content in the response body.
TakoCardNode
object
Slim graph node for the search and answer card surface (TakoCard.nodes). It is deliberately narrower than GraphNode: it carries no aliases and no subtype. Call…
4 properties
3 required
ContentsResponse
object
Response for POST /api/v1/contents. contents is a list so that the contract stays stable if a single result ever yields multiple artifacts. Today it always car…
3 properties
1 required
Specification
The full machine-readable OpenAPI contract behind this narrative.
Source
More from Tako 1
Other APIs Tako publishes across the network.
Tako agent API
#tako