Graph Related

Notes

Authenticated, no credits — send the same X-API-Key header as every Tako endpoint. Graph calls consume no credits; rate limits are 180/minute and 10,000/day.
Start from a node_id returned by Graph Search, then use graph related to find which entity + metric combinations Tako actually covers. Once you’ve found a covered combination, query Search (/v3/search) or Answer (/v1/answer) for it — pinning the ids via sources.data.node_ids.
Results in each group are ranked by popularity, blended with how strongly each node matches q when a filter is provided. On big entities, always pass q — unfiltered, a big entity returns hundreds of items.

Response shape: overview vs. one group

The response always includes the resolved node. The rest depends on whether you paginate:

No relation → relations holds an ordered overview: one group per relation, each {key, kind, label, items (preview), total, total_capped}. Named semantic edges come first, then membership, data, and siblings; empty groups are dropped.
relation=<key> set → relation holds a single paginated page for that one group, with items, total, total_capped, and a next_cursor. Pass next_cursor back as cursor to page through. Items live in relation.items.

Groups by kind:

`kind`	Keys	Meaning
`related`	`rel:<phrase>` — e.g. `rel:competes_with`, `rel:subsidiaries_of`, `rel:in_industry`	Named semantic edges — the richest signal for entities. Keys are per-node: read the overview to discover them, then drill.
`membership`	`part_of`, `members`	Cohort/geo membership (Apple `part_of` FAANG; a league’s `members`).
`data`	`metrics`, `entities`	Table co-reference — the metrics/entities sharing datasets with this node.
`sibling`	`siblings`	Same-type peers — the class namespace (“Other Companies”), not a curated cohort.

An unknown relation key returns 200 with empty items, not an error — so a typo’d key reads as “no relation.” Keys are per-node: read the overview to discover them, then drill.

Narrowing with `q`

The optional q is a case-insensitive substring filter on related nodes’ names/aliases. It filters every group of the overview, or the single paginated group when relation is set:

# Metrics available for an entity, matching "gdp"
curl "https://tako.com/api/beta/graph/related?node_id=$NODE_ID&relation=metrics&q=gdp" \
  -H "X-API-Key: $TAKO_API_KEY"

label/infer_label boosts work as on Graph Search and apply within each group; inference runs only when q is set.

Capped totals

total stops counting at 250: total_capped: true means the true count is at least total — render it as “250+”. Pagination also ends at the cap, so narrow with q to reach the tail.

A 404 means the node_id does not resolve. A node with no relations returns 200 with empty groups — that’s the normal “nothing connected” outcome, not an error.

Example response (overview)

{
  "node": { "id": "ent::nvidia_corporation::5ea55992", "type": "entity", "name": "NVIDIA Corporation", "subtype": "Companies", "label": "ORG" },
  "relations": [
    { "key": "rel:competes_with", "kind": "related", "label": "Competes with",
      "items": [/* GraphNode previews */], "total": 179, "total_capped": false },
    { "key": "rel:subsidiaries_of", "kind": "related", "label": "Subsidiaries of",
      "items": [/* ... */], "total": 24, "total_capped": false },
    { "key": "part_of", "kind": "membership", "label": "Part of",
      "items": [/* ... */], "total": 2, "total_capped": false },
    { "key": "metrics", "kind": "data", "label": "Related Metrics",
      "items": [/* ... */], "total": 250, "total_capped": true },
    { "key": "entities", "kind": "data", "label": "Entities",
      "items": [/* ... */], "total": 62, "total_capped": false },
    { "key": "siblings", "kind": "sibling", "label": "Other Companies",
      "items": [/* ... */], "total": 250, "total_capped": true }
  ]
}

Getting Started

Build with Tako

API Reference

Integrations

Additional Resources

Notes

Response shape: overview vs. one group

Narrowing with `q`

Capped totals

Example response (overview)

​Notes

​Response shape: overview vs. one group

​Narrowing with q

​Capped totals

​Example response (overview)

Notes

Response shape: overview vs. one group

Narrowing with `q`

Capped totals

Example response (overview)