Methods, sources & limits
All 13,649 official foods from the three archives are included; no SR Legacy category subset. Foundation Foods: October 29, 2026, FoodData Central v16.0. Survey: FNDDS 2021–2023, file October 31, 2024. SR Legacy: April 2018, historical final release, no longer updated. Records are deduplicated by data type and official FDC ID.
Food names, categories, nutrient IDs, units, amounts and household measures come directly from official fields. Nutrients are per 100 edible grams. Missing values stay unreported; an official zero remains zero. Nutrient hubs sort descending by reported amount, then FDC ID, within the same official nutrient ID and unit. This is not a health ranking. Different types and recipes are not interchangeable. Short record introductions use only official attributes.
Meal sums scale official nutrient amounts linearly by the chosen official gram weight times quantity divided by 100. Zero-weight portions are displayed on records but cannot be used in calculations. Coverage counts flag incomplete nutrient sums. No Daily Values, calorie needs, health scores or recommended portions are inferred.
PP-NAP joins only exact Survey foodCode to food_code, year 2017/2018 and mod_code NA (not applicable for this cycle). 3,573 records match. Newer survey descriptions or recipes may differ despite a shared code. Unmatched foods have no price; incomplete matched subtotals are labeled. No other dataset types receive a price. PP-NAP 2021–23 is expected no earlier than spring 2027.
Historical 2017–18 national average prices, not today’s grocery prices or what your household pays. They exclude restaurant labor, sales tax, and edible loss. USDA ERS advises against comparing price trends between cycles. Prices are not inflation adjusted; a matching code across cycles does not guarantee an unchanged food recipe. USDA ERS documentation.
Branded Foods is omitted because its October 2026 archive is 187M compressed and roughly 3G expanded. We did not download it. Official brand names already present in Foundation or SR Legacy descriptions are displayed without endorsement.
USDA FoodData Central is U.S. government work. Citation: USDA, Agricultural Research Service, FoodData Central, dataset versions above, retrieved November 15, 2026. The committed manifest records source URLs, HTTP metadata, hashes, counts and UTC ingest time. Builds use that snapshot with no API key. Refreshes use sequential public HTTPS downloads and validate every archive before replacing the snapshot.
Official downloads
- Foundation Foods October 29, 2026; FDC 16.0 — 424 foods
- FNDDS 2021–2023; October 31, 2024 — 5,432 foods
- SR Legacy April 2018; historical final release — 7,793 foods
- PP-NAP 2017–18; updated March 8, 2023
Documentation consulted
- https://fdc.nal.usda.gov/download-datasets/
- https://fdc.nal.usda.gov/docs/Download_Field_Descriptions_Oct2020.pdf
- https://fdc.nal.usda.gov/data-documentation/
- https://fdc.nal.usda.gov/Foundation_Foods_Documentation/
- https://www.ars.usda.gov/northeast-area/beltsville-md-bhnrc/beltsville-human-nutrition-research-center/food-surveys-research-group/docs/fndds-download-databases/
- https://www.ers.usda.gov/data-products/purchase-to-plate/documentation
Educational only. Not dietary or medical advice, a diagnosis, or a meal plan. Food needs vary; this lookup does not set calorie goals or recommend portions.