Open Data API · v0

assistant API

Read-only assistant endpoints, backed by the Scientific Data Engine.

GET/api/v0/assistant/explain

Implemented

A grounded explanation of an entity — its description, its real graph relations, and its cited sources. Deterministic; no language model. Nothing is generated or invented.

Parameter	In	Type	Description
id*	query	string	Entity id to explain.

Returns

{ entity, description?, sources?, links[], citations[] }

Try it

/api/v0/assistant/explain?id=planet:mars

GET/api/v0/assistant/compare

Implemented

Compares two entities by the real common ground between them — the entities they both connect to in the graph. Deterministic; no language model.

Parameter	In	Type	Description
a*	query	string	First entity id.
b*	query	string	Second entity id.

Returns

{ a, b, shared: Ref[] }

Try it

/api/v0/assistant/compare?a=planet:mars&b=planet:venus

GET/api/v0/assistant/path

Implemented

The shortest evidence path between two entities — a real chain of graph relations. Deterministic; no language model. 404 with an honest message when no path exists.

Parameter	In	Type	Description
from*	query	string	Start entity id.
to*	query	string	Target entity id.

Returns

{ from, to, length, path: NeighborNode[] }

Try it

/api/v0/assistant/path?from=astronomer:edwin-hubble&to=cosmology_concept:dark-energy

← All endpoints