API · Early access
Read the graph over HTTP.
The API is the product. The same endpoints serve the public reference pages, our own consumer app, and design partners. During early access the read endpoints below are open at low rate limits; keys and workspaces arrive with the first partners.
Base URL
https://api.analyteatlas.com
Endpoints
- GET /api/v1/biomarkers/
- Paginated list of biomarkers. page, page_size (max 1000), unit.
- GET /api/v1/biomarkers/{key}
- One biomarker: name, aliases, type, unit, connection count.
- GET /api/v1/tests/by-biomarker/{key}
- Laboratory tests that measure a biomarker, with specimen, preparation, LOINC and CPT codes and the laboratory's reference ranges.
- GET /api/v1/tests/
- Paginated list of tests. lab filters by laboratory.
- GET /api/v1/tests/{key}
- One test with its measured biomarkers and details.
- GET /api/v1/conditions/
- Paginated list of conditions, with ICD-10 codes where present.
- GET /api/v1/search/?q=
- Search across the graph. Hybrid semantic retrieval when enabled, BM25 otherwise; the response says which in mode.
- GET /api/v1/semantic/rag/context?q=
- A cited neighbourhood for a query: the seed nodes plus the relationships and their evidence, for grounding an answer.
Example
curl "https://api.analyteatlas.com/api/v1/search/?q=ferritin&limit=5" curl "https://api.analyteatlas.com/api/v1/tests/by-biomarker/ferritin?limit=10"
What every response carries
- Stable keys and slugs per node, so links do not break when names are cleaned up.
- Relationships with their source: the catalog entry, registry record or paper, plus the extraction that produced them and when.
- Reference ranges attributed to the laboratory or guideline body that published them, with the population group and unit.
- Workspace scoping on every query once keys exist: your private additions never mix with the shared graph.
Limits and conduct
Early-access limits are low and unannounced changes are possible while the graph is being seeded. Do not build a production dependency on the open endpoints; ask for a key. Redistribution of the data requires a licence. Questions to hello@analyteatlas.com.