Graph Search
Resolve a metric or entity in Tako’s data graph by name
Notes
- Public and unauthenticated — no API key required.
- Use graph search to discover and confirm what data exists before you query it. Resolve the metric and the entity you care about here, then ask Search (
/v3/search) or Answer (/v1/answer) for that specific entity + metric combination. - Each result is a
GraphNodewhoseidyou can pass straight to Graph Related to explore what it connects to.
Scoping with types
types is a comma-separated list of facets to return. Omit it to search both:
metric— a measure (e.g. “GDP”, “stock price”).entity— a thing the metric is tracked for (e.g. a country, a company).
Disambiguating with subtype
Many names are homonyms — “China” is both a country and several U.S. towns. Pass subtype to scope results to a single entity class so the canonical entity wins:
subtypeimplies entity-only results. Passing it alongside an explicit non-entitytypes(e.g.types=metric) is a400.- The full set of classes is the
subtypeenum in the schema (e.g.Countries,Companies,Cities,People). - Each entity result echoes its resolved class back in
subtype, so you can confirm the match.
subtype is set, results are drawn from a bounded candidate window (min(limit*5, 200)) before filtering. A response shorter than limit does not imply the catalog is exhausted — narrow q instead.Example response
Query Parameters
Search text (min 2 chars).
Comma-separated facets: metric,entity.
Max results (default 20, max 50).
Prefer results with this NER label (boost, not a filter — matching nodes rank higher; others still return). 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. Default true.
Response
Matching metrics and entities
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