Graph Related
Explore the nodes connected to a metric or entity in Tako’s data graph
Notes
- Public and unauthenticated — no API key required.
- 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. - Related is symmetric — for any node, the response groups everything it connects to into
metricsandentities(from the tables the node belongs to). An entity, for example, returns the metrics tracked for it and other entities that appear in the same tables.
Response shape: overview vs. one facet
The response always includes the resolvednode. The rest depends on whether you paginate:
- No
relation_type→relatedholds a grouped overview:metricsandentities, each with its ownitemsandtotal. Use this to see everything a node connects to at a glance. relation_typeset (metric/entity) →relationholds a single paginatedGraphRelationPagefor that one facet, withitems,total, and anext_cursor. Passnext_cursorback ascursorto page through.
Narrowing with q
The optional q is a case-insensitive substring filter on related nodes’ name/aliases. It filters every facet of the overview, or the single paginated facet when relation_type is set:
404 means the node does not exist or has no exportable data.Example response (overview)
Query Parameters
Opaque public id of the node.
Relation key to paginate, e.g. rel:competes_with, metrics, entities, siblings, or members.
Deprecated: use relation. Legacy facet (metric/entity/sibling/member) mapped to a key.
Optional case-insensitive substring filter on the related nodes' name/aliases. Filters every group of the overview, or the single paginated group when relation is set.
Opaque pagination cursor.
Page size (default 50, max 100).
Prefer related nodes with this NER label (boost, not a filter — matching nodes rank higher within each relation; totals are unchanged). Supplying label disables inference.
PERSON, ORG, GPE, LOC, PRODUCT, EVENT, LANGUAGE, MONEY, METRIC, STOCK_TICKER, WEBSITE Infer label and grounded-node boosts from q via Tako NER; set false to disable. Ignored when label is supplied; applies only when q is present. Default true.
Response
A node's details plus related nodes by facet
Labels inferred from q when infer_label ran (boost applied). Empty list: inference ran and found nothing. Absent: an explicit label was given, infer_label=false, or there was no q.
PERSON, ORG, GPE, LOC, PRODUCT, EVENT, LANGUAGE, MONEY, METRIC, STOCK_TICKER, WEBSITE