API Documentation
Structured JSON API for sleep evidence. Designed for AI agents, health apps, and developers.
Note: The API is in beta. All endpoints return JSON. No authentication required during MVP.
Endpoints
GET
/api/claim/{slug}Returns structured claim data including confidence score, RCT count, dose, and population.
GET /api/claim/glycine-sleep-latency
Response:
{
"slug": "glycine-sleep-latency",
"text": "Glycine reduces sleep latency in human RCTs",
"confidence": 91,
"confidenceLevel": "high",
"rcts": 3,
"meta": 0,
"dose": "3g",
"population": ["Healthy adults", "Adults with mild sleep complaints"],
"evidenceScore": 91,
"lastUpdated": "2026-06-15T00:00:00Z"
}
Try it →GET
/api/evidence/{topic}Returns aggregated evidence for a topic/compound, including all related claims and study counts.
GET /api/evidence/magnesium
Response:
{
"topic": "Magnesium",
"summary": "An essential mineral involved in GABA regulation...",
"strength": "moderate",
"studies": 3,
"claims": [
{
"slug": "magnesium-sleep-quality",
"text": "Magnesium supplementation improves sleep quality...",
"score": 84
}
]
}
Try it →GET
/api/search?q={query}Search across all claims by keyword, compound, or text.
GET /api/search?q=glycine&limit=5
Response:
{
"query": "glycine",
"count": 2,
"results": [
{
"slug": "glycine-sleep-latency",
"text": "Glycine reduces sleep latency...",
"evidenceScore": 91,
"dose": "3g",
"rcts": 3,
"url": "/claim/glycine-sleep-latency"
}
]
}
Try it →MCP Server (Roadmap)
An MCP (Model Context Protocol) server is planned to allow AI agents (ChatGPT, Claude, Gemini) to directly query the Evidence Graph. This will enable:
get_claim(slug)— Retrieve a full claim with evidencesearch_evidence(query)— Natural language searchget_dose(compound)— Get optimal dose rangescompare(compound_a, compound_b)— Compare evidence strength
Target: Q3 2026
Rate Limits
MVP: No rate limits. Production will include tiered access:
- Free: 100 requests/day
- Pro: 10,000 requests/day
- Enterprise: Unlimited + MCP access
Ready to build?
All endpoints are live and return JSON. No API key needed during MVP.
View Sample Response