API

Every supplement, study, exercise, and outcome on this site is available as JSON. Free, no API key, plain GET requests.

Base URL

https://evidenceengine.dev

Auth

None

Rate limit

120 requests / min per IP

Over the limit you get HTTP 429; wait a minute and retry. Supplement responses include a source_url to cite.

Search

GET/agent/search?q={terms}

Find supplements, studies, and exercises. Works with names (fish oil), goals (joint pain), combinations (magnesium sleep), and questions (what helps with sleep). Returns IDs to use with the endpoints below, plus the matched health outcome.

limit — results per type, default 5, max 15

/agent/search?q=creatine+strength

Supplements

GET/agent/supplement/{id}

Overview: summary, evidence quality, dosing, timing, key findings, practical recommendations, safety summary, interactions, and the top 5 studies.

/agent/supplement/creatine

GET/agent/supplement/{id}/safety

Toxicity, side effects, contraindications, drug interactions, FDA adverse-event reports, and upper limit.

/agent/supplement/ashwagandha/safety

GET/agent/supplement/{id}/dosing

Dosing consensus, timing, forms, RDA, upper limit, EFSA conditions of use, and populations studied.

/agent/supplement/vitamin-d/dosing

GET/agent/supplement/{id}/evidence

Evidence quality, breakdown of study results and study types, key findings, and the top 8 studies with meta-analyses first.

/agent/supplement/caffeine/evidence

GET/agent/compare?ids={a},{b}

Side-by-side comparison of 2–4 supplements: evidence quality, dosing, key findings, safety, and study counts.

/agent/compare?ids=creatine,beta-alanine

Health outcomes

GET/agent/outcome/{id}

Supplements for a health goal, ranked by efficacy: established, probable, possible, insufficient.

limit — default 15, max 30

/agent/outcome/sleep-quality

GET/outcomes

All 45 outcome categories with their IDs, grouped by area.

/outcomes

Exercises

GET/agent/exercise/{id}

Coaching cues, common mistakes, progressions, regressions, rep ranges, contraindications, and muscles worked.

/agent/exercise/Barbell_Squat

GET/exercises

Browse exercises.

muscle, equipment, level, category, limit (max 200), offset

/exercises?muscle=quadriceps&limit=5

Studies

GET/studies/{pmid}

Full study record: abstract, intervention, population, outcomes, result direction, takeaway, and linked supplements and exercises.

/studies/28615996

GET/studies/search?q={terms}

Full-text search across titles, abstracts, and extracted findings.

type — e.g. meta-analysis, rct; limit — default 20, max 100

/studies/search?q=beta+alanine&type=meta-analysis

IDs

Type	Format	Examples
Supplement	kebab-case slug	`creatine`, `vitamin-d`, `omega-3-fatty-acids`
Outcome	kebab-case slug	`muscle-strength`, `sleep-quality`, `fat-loss`
Exercise	database ID	`Barbell_Squat`, `Dumbbell_Bicep_Curl`
Study	PubMed ID	`28615996`

Not sure of an ID? Search first, or list them with /ingredients and /outcomes.

Example

curl 'https://evidenceengine.dev/agent/search?q=sleep'
curl https://evidenceengine.dev/agent/supplement/melatonin
curl https://evidenceengine.dev/agent/supplement/melatonin/safety