Get a graph node by id
Data Graph
Graph Node
Look up a single node in Tako’s data graph by its id
GET
Get a graph node by id
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. - Use graph node to confirm what a node id actually refers to. Given an id — from a Search or Answer card, from Graph Search, or from Graph Related — resolve it here to get the node’s full
name,aliases, anddescriptionand verify it’s the entity or metric you expected before you rely on it. - The
idis the opaque public id Tako returns everywhere it exposes a node. The same id works across all graph endpoints.
Disambiguation flow
The node id is the through-line that ties search results back to the graph. A typical loop:- Run a Search or Answer query and read the node ids off the card’s
nodesarray. - Resolve each id here to confirm the card was built from the entities and metrics you meant — compare
name,aliases, andlabel. The names themselves settle homonyms:Chinathe country andChina, TXare distinct nodes with distinct ids. - If a node isn’t the one you wanted, resolve the intended one with Graph Search instead, then re-run the query pinned to that id via
sources.data.node_ids.
Path format
The path takes the full opaque id, so URL-encode it — ids contain::. The trailing slash is required; without it Tako responds 301 to the canonical path, which clients only follow when told to (curl -L).
Example response
A
404 means the id does not resolve to a node — either it’s malformed, it uses an unknown prefix, or no such node exists.Authorizations
Path Parameters
Opaque public id of the node.
Response
A single graph node
Opaque, human-friendly public id (::::, where prefix is ent for an entity or mt for a metric). Ids are not durable across knowledge-graph rebuilds — resolve them at request time rather than storing them.
Available options:
metric, entity Available options:
Companies, Cryptocurrencies, Financial Instruments, Internet Browsers, Commodities, People, Currencies, Stock Exchanges, Securities, IPOs, Government Debt Instruments, Treasury Securities, Airports, Airlines, Vehicle Types, Transportation Modes, Drugs, Drug Categories, Diseases, Injury Mechanisms, Injury Intents, Chemical Elements, Chemical Compounds, Celestial Bodies, Occupations, Social Media Platforms, Operating Systems, Search Engines, Device Types, LLMs, LLM Families, LLM Benchmarks, AI Gateway Entity, Industries, NAICS Industries, BLS Industries, PSC Categories, Purchase Categories, Federal Contractors, Federal Agencies, Federal Subagencies, ICE Contracts, ICE Contractors, Elections, Political Offices, Pollsters, Agricultural Products, Tobacco Products, Prediction Markets, Prediction Events, Real Estate Property Types, Continents, World Regions, Countries, States, Counties, Metro Areas, Cities, F1 Drivers, F1 Teams, F1 Circuits, F1 Events, NASCAR Drivers, NASCAR Teams, NASCAR Tracks, NASCAR Events, NASCAR Races, NASCAR Owners, NASCAR Manufacturers, Golf Players, Golf Tournaments, Golf Venues, Golf Courses, Soccer Teams, Soccer Players, Soccer Competitions, Soccer Conferences, Basketball Teams, Basketball Players, Basketball Conferences, Basketball Divisions, Baseball Teams, Baseball Players, Baseball Conferences, Baseball Divisions, Baseball Competitions, Football Teams, Football Players, Football Conferences, Football Divisions, Sports, Sports Leagues Public NER label of the node (PERSON, ORG, GPE, ...). Derived from the node's stored annotation; null when the internal annotation has no public equivalent.
Available options:
PERSON, ORG, GPE, LOC, PRODUCT, EVENT, LANGUAGE, MONEY, METRIC, STOCK_TICKER, WEBSITE