Quickstart

Make your first call to the AllNutrition API in under a minute. No account, no API key.

1. Send a request

The simplest call: ask a nutrition question and get a cited answer.

curl -X POST https://www.allnutrition.info/api/v1/ask \
  -H "Content-Type: application/json" \
  -d '{"question": "How much vitamin D should an adult take daily?"}'

2. Read the response

You get an evidence-tagged answer plus citations.

{
  "question": "How much vitamin D should an adult take daily?",
  "answer": "Most adults need **600–800 IU (15–20 mcg) of vitamin D per day** ...",
  "evidence_strength": "strong",
  "consensus_level": "high",
  "last_updated": "2024-03-12T00:00:00Z",
  "sources": [
    {
      "id": "8f4e1c8a-9b6d-4f3e-9a12-0e7d2b6c1a44",
      "title": "Vitamin D — Fact Sheet for Health Professionals",
      "url": "https://ods.od.nih.gov/factsheets/VitaminD-HealthProfessional/",
      "publisher": "NIH Office of Dietary Supplements",
      "publisher_short_name": "NIH ODS",
      "evidence_level": "guideline",
      "trust_score": 0.92,
      "published_at": "2024-03-12T00:00:00Z",
      "excerpt": "The Recommended Dietary Allowance for adults 19–70 ..."
    }
  ]
}

3. Mind the rate limit

The public API allows 10 requests per IP per UTC day. Every response (success or error) carries headers so you can self-throttle:

RateLimit-Limit: 10
RateLimit-Remaining: 7
RateLimit-Reset: 41218

See Rate limits & errors for the full contract.

4. Pick the right endpoint

5. Next steps