Developer Documentation

Quick Start

bash

curl -s "https://citedhealth.com/api/ingredients/?page_size=2"

Example response

{
  "count": 15,
  "next": "https://citedhealth.com/api/ingredients/?page=2&page_size=2",
  "previous": null,
  "results": [
    {
      "id": 1,
      "name": "Biotin",
      "slug": "biotin",
      "category": "vitamins",
      "mechanism": "Supports keratin synthesis",
      "is_featured": true
    },
    {
      "id": 2,
      "name": "Saw Palmetto",
      "slug": "saw-palmetto",
      "category": "herbs",
      "mechanism": "5-alpha reductase inhibition",
      "is_featured": true
    }
  ]
}

API Endpoints

Method	Endpoint	Description
GET	/api/ingredients/	List all ingredients for this site
GET	/api/papers/	List indexed PubMed papers
GET	/api/evidence/	List evidence links with grades
GET	/embed/{ingredient}/for/{condition}/data.json	Embeddable badge data (CORS-enabled)
GET	/embed/{ingredient}/for/{condition}/badge.js	Self-contained JS badge widget
GET	/cite/{ingredient}/for/{condition}/	Citation formats (APA, MLA, BibTeX)

Embed Evidence Badges

Add evidence badges to your site with a single script tag. The badge shows the evidence grade, study count, and links back to the full evidence review.

<script src="https://citedhealth.com/embed/biotin/for/hair-loss/badge.js"></script>

OpenAPI Specification

The full API specification is available as OpenAPI 3.1.0 JSON:

/api/openapi.json

LLM-Friendly Endpoints

All pages support a .md suffix for markdown output optimized for AI assistants:

curl -s "https://citedhealth.com/ingredients/biotin/.md"

Usage

✓ Free to use, no API key required
✓ CORS enabled on embed endpoints
✓ JSON responses with pagination (20 per page, max 100)
✓ Please link back to the evidence page when using our data