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 operations7 paths46 schemas3 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
searchbody→ 200400401408
POST
/v1/answer
Answer
answerbody→ 200400401408
GET
/beta/graph/search
Search the data graph
graphSearch5 params→ 200400503
GET
/beta/graph/related
Get a graph node's related nodes
graphRelated8 params→ 200400404503
GET
/beta/graph/node/{id}
Get a graph node by id
graphNode1 param→ 200404503
POST
/v1/contents
Download content
contentsbody→ 200400401403404
POST
/v1/thin_viz/create/
Create card
createCardbody→ 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 properties6 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 properties2 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 properties5 required
TakoCardSource
object
A source that backs a TakoCard on the SDK surfaces. It uses the {data, web} TakoSourceIndex taxonomy.
5 properties1 required
AnswerResponse
object
Response for POST /api/v1/answer: the synthesized answer plus the retrieval behind it.
5 properties2 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 properties2 required
ComponentConfig
object
Configuration for a single component in a card.
3 properties2 required
TakoDatasetColumn
object
Typed header entry; type is the JSON-facing column type.
2 properties2 required
SearchRequest
object
7 properties1 required
CreateCardRequest
object
Request model for creating a card directly with components.
8 properties1 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 properties3 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 properties1 required
UsageCompute
object
The cost of running the operation. Absent on surfaces with no compute step (contents).
1 property1 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 properties2 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 properties1 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 properties1 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 properties4 required
BaseAPIError
object
2 properties2 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 properties1 required
SearchResponse
object
4 properties1 required
GraphRelatedResponse
object
4 properties1 required
KnowledgeCardMethodology
object
2 properties2 required
OutputSettings
object
2 properties
GraphRelation
object
6 properties5 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 properties1 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 properties1 required
GraphNode
object
7 properties3 required
Specification
The full machine-readable OpenAPI contract behind this narrative.
Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.
Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.
MCP tools for apis
4 tools reach this content
search_api_evangelistSearch every content type across the network at once.
find_relatedThe shared-tag relevance graph — what else covers this.
get_tagEverything one tag labels, across all content types.
guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
A second provider on the same verified email joins the account you already have.
Your account
ⓘ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.