Developer Documentation
Comprehensive nutrition facts database. Foods from USDA, Korean MFDS, Japanese MEXT, and Open Food Facts, with detailed nutrition data per 100g (40+ nutrients), food categories, N-squared food comparisons, diet types, nutrition rankings, glossary terms, guides, and interactive tools in 15 languages.
- Foods with names (14 language translations), serving sizes, common servings, source IDs
- Data sources: USDA SR Legacy (7,793), USDA Foundation (560+), Korean MFDS (92,000+), Japanese MEXT (2,538), Open Food Facts
- Nutrition facts per 100g: macronutrients, 11 vitamins, 7 minerals, 5 amino acids, water
- Computed macro percentages (protein/fat/carb calorie distribution, 4-9-4 rule)
- Hierarchical food categories (50 categories with parent-child relationships)
- N-squared food comparisons with pre-computed diffs and winners across 8 metrics
- Diet types with filtering rules (keto, vegan, paleo, mediterranean, etc.)
- Nutrition rankings by metric and category (330+ ranking pages)
- Glossary terms across 13 nutrition categories (macronutrient, vitamin, mineral, amino acid, etc.)
- Guides in 10 series (nutrition basics, sports nutrition, weight management, etc.)
- Interactive tools (TDEE calculator, macro calculator, meal planner)
Quick Start
curl -s "https://nutrifyi.com/api/v1/foods/?limit=5"
API Endpoints
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/v1/foods/ | List foods (paginated) |
| GET | /api/v1/foods/{id}/ | Food detail with nutrition facts |
| GET | /api/v1/categories/ | List food categories |
| GET | /api/v1/categories/{id}/ | Category detail |
| GET | /api/v1/comparisons/ | Food comparisons |
| GET | /api/v1/comparisons/{id}/ | Comparison detail |
| GET | /api/v1/diets/ | Diet types |
| GET | /api/v1/diets/{id}/ | Diet type detail |
| GET | /api/v1/glossary/ | Glossary terms |
| GET | /api/v1/glossary/{id}/ | Glossary term detail |
| GET | /api/v1/guides/ | Guide articles |
| GET | /api/v1/guides/{id}/ | Guide detail |
| GET | /api/v1/faqs/ | FAQs |
| GET | /api/v1/search/?q={query} | Search foods |
| GET | /api/v1/stats/ | Site statistics |
URL Patterns
Use these patterns to construct URLs programmatically:
/foods/
Food directory (paginated) (e.g. /foods/)
/food/{slug}/
Food detail with full nutrition facts (e.g. /food/banana/)
/categories/
Food categories list (e.g. /categories/)
/category/{slug}/
Category detail with foods (e.g. /category/fruits/)
/compare/
Food comparison list (e.g. /compare/)
/compare/{slug}/
Compare two foods (nutrition diff) (e.g. /compare/banana-vs-apple/)
/diets/
Diet types list (e.g. /diets/)
/diet/{slug}/
Diet detail with compatible foods (e.g. /diet/keto/)
/rankings/
Nutrition rankings index (e.g. /rankings/)
/ranking/{metric}/{category}/
Ranking by metric and category (e.g. /ranking/lowest-calorie/fruits/)
/glossary/
Nutrition glossary (e.g. /glossary/)
/glossary/{slug}/
Glossary term definition (e.g. /glossary/protein/)
/guides/
Nutrition guide series (e.g. /guides/)
/guides/{series_slug}/
Guide series (e.g. /guides/nutrition-basics/)
/guides/{series_slug}/{slug}/
Guide article (e.g. /guides/nutrition-basics/macronutrients/)
/tools/
Interactive nutrition tools (e.g. /tools/)
/tools/{slug}/
Tool page (e.g. /tools/tdee-calculator/)
/search/
Search foods (e.g. /search/?q=banana)
Response Format
All endpoints return JSON with pagination:
Example JSON response
{
"count": 636,
"next": "https://example.com/api/v1/items/?page=2",
"previous": null,
"results": [
{"slug": "example", "name": "Example Item", "...": "..."}
]
}
Format Support
- Markdown endpoints: Append
.mdto any page URL for LLM-friendly markdown output. - Internationalization: Content available in 14 languages: ko, ja, zh-hans, es, fr, de, pt, ru, vi, tr, ar, hi, th, id.