Skip to main content
GET
Get a graph node by id

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.
  • 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, and description and verify it’s the entity or metric you expected before you rely on it.
  • The id is the opaque public id Tako returns everywhere it exposes a node. The same id works across all graph endpoints.
A resolved node describes what Tako knows about that id — it does not promise that any specific entity + metric combination exists, or that data is available for it. Use Graph Related to see what a node connects to, and confirm coverage at Search or Answer.

Disambiguation flow

The node id is the through-line that ties search results back to the graph. A typical loop:
  1. Run a Search or Answer query and read the node ids off the card’s nodes array.
  2. Resolve each id here to confirm the card was built from the entities and metrics you meant — compare name, aliases, and label. The names themselves settle homonyms: China the country and China, TX are distinct nodes with distinct ids.
  3. 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

X-API-Key
string
header
required

Path Parameters

id
string
required

Opaque public id of the node.

Response

A single graph node

id
string
required

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.

type
enum<string>
required
Available options:
metric,
entity
name
string
required
aliases
string[]
description
string | null
subtype
enum<string> | null
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
label
enum<string> | null

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