# NutriFYI

> 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.

## Data Scope
- 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)

## URL Patterns
- Append `.md` to any URL for plain-text markdown format.
- i18n: URL prefix `/{lang}` for non-English (ko, ja, zh-hans, es, fr, de, pt, ru, vi, tr, ar, hi, th, id).
- `/foods/` — Food directory (paginated) (e.g. `/foods/`)
- `/food/{slug}/` — Food detail with full nutrition facts (e.g. `/food/bananas-raw/`)
- `/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/honey-vs-mangos-raw/`)
- `/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/calories/all/`)
- `/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/complete-guide-to-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`)

## Browse Foods
- [All Foods](https://nutrifyi.com/foods/)
- [Food Categories (50)](https://nutrifyi.com/categories/)
- [Diet Types](https://nutrifyi.com/diets/)

## Compare & Rank
- [Food Comparisons](https://nutrifyi.com/compare/)
- [Nutrition Rankings](https://nutrifyi.com/rankings/)

## Guides & Education
- [All Guides](https://nutrifyi.com/guides/)
- [Glossary](https://nutrifyi.com/glossary/)

## Interactive Tools
- [All Tools](https://nutrifyi.com/tools/)

## Embed Widget
- [NutriFYI Widget Docs](https://widget.nutrifyi.com)
- [nutrifyi-embed on npm](https://www.npmjs.com/package/nutrifyi-embed)
- [nutrifyi-embed on GitHub](https://github.com/fyipedia/nutrifyi-embed)

## REST API

Free REST API. No authentication required. JSON responses. CORS enabled.

| 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 |

```bash
curl -s "https://nutrifyi.com/api/v1/foods/?limit=5"
```

[API Docs](https://nutrifyi.com/developers/)

## Health FYI Family

Part of [FYIPedia](https://fyipedia.com) developer tools ecosystem.
- [AnatomyFYI](https://anatomyfyi.com) — 14,692 anatomical structures, systems, organs
- [PillFYI](https://pillfyi.com) — Pill identification, FDA/MFDS drug database
- [DrugFYI](https://drugfyi.com) — Drug interactions, pharmacology, side effects
- [NutriFYI](https://nutrifyi.com) — Nutrition data, food composition, dietary analysis

## Images (CDN)

OG images at https://cdn.nutrifyi.com/og/
- https://cdn.nutrifyi.com/og/homepage.png

## Full Index
- [Full content index](https://nutrifyi.com/llms-full.txt)
- [XML Sitemap](https://nutrifyi.com/sitemap.xml)