# AllNutrition

> AllNutrition is an evidence-based nutrition platform. It answers nutrition
> questions using peer-reviewed research, clinical guidelines, and expert
> position statements, returning answers with citations and explicit
> evidence-strength and consensus labels. The public API is unauthenticated and
> rate-limited to 10 requests per IP per UTC day.

Preferred-Content: https://docs.allnutrition.info
API: https://www.allnutrition.info/api/v1/ask
OpenAPI: https://www.allnutrition.info/openapi.json
Interactive-Docs: https://www.allnutrition.info/docs

## Documentation

- [Overview](https://docs.allnutrition.info/): What the API is and what to build with it.
- [Quickstart](https://docs.allnutrition.info/quickstart.html): First request in under a minute.
- [API reference](https://docs.allnutrition.info/api-reference.html): Endpoints, request/response shapes, source object.
- [Evidence & consensus](https://docs.allnutrition.info/concepts.html): The evidence_strength, consensus_level, evidence_level, and trust_score taxonomy.
- [Rate limits & errors](https://docs.allnutrition.info/rate-limits.html): 10 req/IP/day, headers, 429 shape.
- [Code examples](https://docs.allnutrition.info/examples.html): curl, Python, JavaScript, TypeScript, Go.
- [AI agents & tools](https://docs.allnutrition.info/agents.html): OpenAI tool use, Claude tool use, GPT Actions, LangChain, Vercel AI SDK.

## Endpoints

- POST https://www.allnutrition.info/api/v1/ask — answer a nutrition question with citations.
- POST https://www.allnutrition.info/api/v1/references/search — semantic reference search, no LLM call.
- GET  https://www.allnutrition.info/api/v1/health — public health probe.
- GET  https://www.allnutrition.info/openapi.json — OpenAPI 3.1 spec.
- GET  https://www.allnutrition.info/docs — interactive Scalar explorer.

## Response taxonomy

- evidence_strength: strong | moderate | limited | insufficient
- consensus_level: high | moderate | mixed | low
- evidence_level (per source): guideline | systematic_review | rct | observational | expert_opinion | review
- trust_score (per source): float in [0, 1] — composite of authority × recency × evidence × consensus.

## Authentication

The /api/v1/* endpoints are public and require no API key. For partner-tier
volume, contact support@allnutrition.info.

## Optional

- [Terms of Service](https://www.allnutrition.info/terms)
- [Privacy](https://www.allnutrition.info/privacy)