Graph Related
Explore the nodes connected to a metric or entity in Tako’s data graph
Notes
- Authenticated, no credits — send the same
X-API-Keyheader as every Tako endpoint. Graph calls consume no credits; rate limits are 180/minute and 10,000/day. - Start from a
node_idreturned 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 viasources.data.node_ids. - Results in each group are ranked by popularity, blended with how strongly each node matches
qwhen a filter is provided. On big entities, always passq— unfiltered, a big entity returns hundreds of items.
Response shape: overview vs. one group
The response always includes the resolvednode. The rest depends on whether you paginate:
- No
relation→relationsholds 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 →relationholds a single paginated page for that one group, withitems,total,total_capped, and anext_cursor. Passnext_cursorback ascursorto page through. Items live inrelation.items.
kind:
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:
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.
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)
Authorizations
Query Parameters
Opaque public id of the node.
Relation key to paginate, for example rel:competes_with, metrics, entities, siblings, or members.
Deprecated: use relation. A legacy facet name (metric, entity, sibling, or member) that maps to a key.
Optional case-insensitive substring filter on the related nodes' names and aliases. It filters every group of the overview, or the single paginated group when you set relation.
Opaque pagination cursor.
Page size (default 50, max 100).
Prefer related nodes with this NER label. This is a boost, not a filter: matching nodes rank higher within each relation, and totals do not change. Supplying label disables inference.
PERSON, ORG, GPE, LOC, PRODUCT, EVENT, LANGUAGE, MONEY, METRIC, STOCK_TICKER, WEBSITE When true, Tako NER infers the label and grounded-node boosts from q. Set false to disable. Tako ignores this parameter when you supply label. It applies only when q is present. Default true.
Response
A node's details plus related nodes by facet
Labels that Tako NER inferred from q when infer_label ran (boost applied). An empty list means inference ran and found nothing. The field is absent when you supplied an explicit label, when infer_label=false, or when there was no q.
PERSON, ORG, GPE, LOC, PRODUCT, EVENT, LANGUAGE, MONEY, METRIC, STOCK_TICKER, WEBSITE