How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Tako API

The tako API from Tako — 7 operation(s) for 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.2.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.

Specification
OpenAPI 3.2.0
API Version
1.0.0
Base URL
https://tako.com/api
Authentication
API Key
Resource Areas
1

Authentication & Security 1

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
search body → 200400401408
POST
/v1/answer
Answer
answer body → 200400401408
GET
/beta/graph/search
Search the data graph
graphSearch 5 params → 200400503
GET
/beta/graph/related
Get a graph node's related nodes
graphRelated 8 params → 200400404503
GET
/beta/graph/node/{id}
Get a graph node by id
graphNode 1 param → 200404503
POST
/v1/contents
Download content
contents body → 200400401403404
POST
/v1/thin_viz/create/
Create card
createCard body → 200400404500

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.

NerLabel
string
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
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
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
TakoCard
object
A Tako knowledge card on the search and answer surfaces. It carries a content download descriptor.
17 properties
GraphRelationPage
object
7 properties 5 required
TakoCardSource
object
A source that backs a TakoCard on the SDK surfaces. It uses the {data, web} TakoSourceIndex taxonomy.
5 properties 1 required
AnswerResponse
object
Response for POST /api/v1/answer: the synthesized answer plus the retrieval behind it.
5 properties 2 required
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
ComponentConfig
object
Configuration for a single component in a card.
3 properties 2 required
TakoDatasetColumn
object
Typed header entry; type is the JSON-facing column type.
2 properties 2 required
SearchRequest
object
7 properties 1 required
CreateCardRequest
object
Request model for creating a card directly with components.
8 properties 1 required
ComponentTypeEnum
string
Component types supported for thin viz schemas with builder support. These component types have dedicated builders that process configurations, add defaults, a…
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
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
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
UsageCompute
object
The cost of running the operation. Absent on surfaces with no compute step (contents).
1 property 1 required
SourceSettings
object
2 properties
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…
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
ContentsDeliveryMode
string
How contents reach the caller. URL returns a short-lived presigned file download; INLINE returns the content in the response body.
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
ContentsFormat
string
Serialization of tabular (Tako card) data. Web content is always raw text and carries no content format (contentformat is null).
TakoSourceIndex
string
Public source taxonomy for the SDK card surfaces (v3 search, v1 answer, agent). It is symmetric with the request taxonomy {data, web}.
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
APIErrorType
string
GraphNodeType
string
GraphSearchResponse
object
2 properties 1 required
EntityClassName
string
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
BaseAPIError
object
2 properties 2 required
KnowledgeCardRelevance
string
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
SearchResponse
object
4 properties 1 required
GraphRelatedResponse
object
4 properties 1 required
KnowledgeCardMethodology
object
2 properties 2 required
OutputSettings
object
2 properties
GraphRelation
object
6 properties 5 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…
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
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
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
RelationKind
string
How Tako derived a relation group.
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
GraphNode
object
7 properties 3 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

tako-tako-api-openapi.yml Raw ↑

Other APIs Tako publishes across the network.

Tako Agent API
Where this information came from

This is an independent, third-party profile of Tako API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.