API Reference

Stable, public endpoints under /api/v1. Hosted at https://www.allnutrition.info. A free API key is required (Authorization: Bearer ank_…, created under Settings → API keys); every account gets the same daily allowance — see Rate limits.

Endpoints at a glance

POST /api/v1/ask

Answer a nutrition question with peer-reviewed citations.

Request body

Response (200)

Example

curl -X POST https://www.allnutrition.info/api/v1/ask \
  -H "Content-Type: application/json" \
  -d '{"question": "Is creatine safe for adolescents who lift weights?"}'

Deep research

Set "deep_research": true to trade latency for depth. Instead of a single retrieval pass, the pipeline expands your question into 3–8 targeted sub-queries (e.g. safety, efficacy, mechanisms), retrieves and merges sources for each, and synthesizes a comprehensive Markdown report with inline citations and a summary section. Expect responses in 30–90 seconds and a much longer answer. A deep-research call counts as one request against the rate limit.

Shareable Ask sessions

Set "share": true to persist the question and answer as a public, read-only Ask session. The response's share_url points to a web page (https://www.allnutrition.info/shared/<slug>) showing the question, the answer, and its citations — useful for handing users a permanent, human-readable link from a chatbot or agent. Notes:

• Anyone with the link can view the session; the slug is unguessable but the page is not access-controlled.
• Sharing cannot be revoked through the public API — contact support@allnutrition.info to remove a link.
• Don't enable share for questions containing personal or sensitive information.
• Composable with deep_research — the shared page then shows the full report.

curl -X POST https://www.allnutrition.info/api/v1/ask \
  -H "Content-Type: application/json" \
  -d '{
    "question": "What does the evidence say about intermittent fasting?",
    "deep_research": true,
    "share": true
  }'
# → { ..., "deep_research": true,
#     "share_url": "https://www.allnutrition.info/shared/Ab3dEf9hIj2kLm5n" }

POST /api/v1/ask/prompt

Retrieve the evidence for a question and return it as an evidence pack for your own model: no answer is generated on our side, so the call is fast (a few seconds). Retrieval is the same as /api/v1/ask; because the excerpts are returned word for word, the pack holds only abstracts and openly licensed (CC BY) full text. This is what the MCP ask_nutrition tool returns to ChatGPT and Claude.

Request body

Response (200)

curl -X POST https://www.allnutrition.info/api/v1/ask/prompt \
  -H "Authorization: Bearer ank_your_key" \
  -H "Content-Type: application/json" \
  -d '{"question": "Is creatine safe for healthy adults to take daily?"}'

POST /api/v1/references/search

Return ranked sources for a query without generating an answer.

Request body

Response (200)

Source object

Both endpoints return sources with the same shape.

Errors

Interactive explorer

Try requests live against the API in the interactive Scalar explorer →

The interactive explorer is rendered from the same OpenAPI spec served at /openapi.json. You can download the spec and use it with Postman, Insomnia, Stoplight, or any OpenAPI-compatible tool.