Overview
US on-demand search/detail from USDA FoodData Central; UK search/detail from all 2,886 food records in a versioned CoFID 2021 snapshot. The API preserves provider IDs, nutrient units, source basis, and CoFID trace/not-reported statuses. US data is fetched from the live FDC API for each successful request. UK data is a pinned CoFID 2021 release; it changes only when a new source snapshot is imported and released.
Data sources
- USDA FoodData Central API CC0 1.0; attribution requested to USDA Agricultural Research Service
- McCance and Widdowson’s Composition of Foods Integrated Dataset (CoFID 2021) Open Government Licence v3.0
What this is not
- ✕ medical, clinical, diet or treatment advice
- ✕ recipe nutrition estimates or nutrient totals for prepared meals
- ✕ allergen-safety determinations
- ✕ guaranteed product label accuracy or current branded-food availability
Known limitations
- FDC nutrient basis varies by record type and is returned as provider-reported; callers should inspect the source record before comparing values
- CoFID nutrient basis is preserved per nutrient; most values are per 100 g of food, while fatty-acid tables may use a fatty-acid basis
- A missing, trace or not-detected source value is not converted to zero
- Records are food-composition references, not lab measurements of a particular product or meal
- Search is text matching and does not guarantee that similarly named foods are equivalent
- The data is informational only, not medical or clinical advice
Inspect a UK source record
Review a real CoFID 2021 food-composition record, its units and source-specific status before integration.
View CoFID sample and schema →Static CoFID sample. Live USDA FDC and UK CoFID routes are available from the REST endpoint.
Try the live beta
UK CoFID is live · USDA FoodData Central key setup pending
Call UK CoFID
Use GET /v1/nutrition/uk/search?q=porridge%20oats&payment=false for a free, live preview of the pinned 2021 dataset.
Preserve provenance
Every record includes a source ID and dataset version. UK queries use the pinned CoFID 2021 release.
Keep missing values unknown
Trace and missing source values are not converted to zero. Results are not clinical or medical guidance.
Call GET https://bb457y9nc28rvwv3.7dn.lambda-web.eu-west-2.on.aws/v1/nutrition/uk/search?q=porridge%20oats&limit=5&payment=false for UK CoFID 2021 or GET https://bb457y9nc28rvwv3.7dn.lambda-web.eu-west-2.on.aws/v1/nutrition/us/search?q=black%20beans&limit=5&payment=false for USDA FoodData Central. Both use `payment=false` for the free preview, limited to five requests per minute per client IP. Preserve source basis, units, missing-value status and provenance. This is not medical advice.
REST endpoints
Live US USDA FoodData Central and UK CoFID 2021 routes
GETnutrition_us_searchSearch USDA FoodData Central records.✓ Live beta
GET https://bb457y9nc28rvwv3.7dn.lambda-web.eu-west-2.on.aws/v1/nutrition/us/search?q=black%20beans&limit=5&payment=false
Free previews use payment=false and are limited to five requests per minute per client IP.
GETnutrition_us_getRetrieve an exact USDA FDC record.✓ Live beta
GET https://bb457y9nc28rvwv3.7dn.lambda-web.eu-west-2.on.aws/v1/nutrition/us/foods/173735?payment=false
Free previews use payment=false and are limited to five requests per minute per client IP.
GETnutrition_uk_searchSearch the CoFID 2021 snapshot.✓ Live beta
GET https://bb457y9nc28rvwv3.7dn.lambda-web.eu-west-2.on.aws/v1/nutrition/uk/search?q=porridge%20oats&limit=5&payment=false
Free previews use payment=false and are limited to five requests per minute per client IP.
GETnutrition_uk_getRetrieve one exact CoFID record.✓ Live beta
GET https://bb457y9nc28rvwv3.7dn.lambda-web.eu-west-2.on.aws/v1/nutrition/uk/foods/11-788?payment=false
Free previews use payment=false and are limited to five requests per minute per client IP.