Skip to main content
All providers

USDA FoodData Central

HealthUS

api.nal.usda.gov

Nutrient composition for hundreds of thousands of foods, from the US Department of Agriculture.

Capabilities (6)

GET /v1/data/usda-food/barcode1 credit

Looks up the packaged product behind a retail barcode and returns its single Branded match with FDC ID, brand owner, ingredient list, serving size and label nutrients.

gtinUpc
GET /v1/data/usda-food/food1 credit

Returns one FoodData Central record: description, data type, publication date, and the nutrient table with amounts, units and derivation - plus ingredients, serving size, label nutrients and portions for branded and Foundation foods.

fdcIdformat?nutrients?
GET /v1/data/usda-food/foods1 credit

Returns an array of food records for many FDC IDs in one call, each with its description, data type and nutrient table at the requested detail level.

fdcIdsformat?nutrients?
GET /v1/data/usda-food/list1 credit

Returns a page of abridged food records straight out of a FoodData Central dataset with no search term - FDC ID, description, data type, publication date (null on some older records) and summary nutrients.

dataType?pageSize?pageNumber?sortBy?sortOrder?
GET /v1/data/usda-food/search1 credit

Full-text search over FoodData Central, returning each match's FDC ID, description, data type, brand owner, GTIN/UPC and a summary nutrient list, plus totalHits and totalPages for paging.

querydataType?pageSize?pageNumber?sortBy?sortOrder?brandOwner?requireAllWords?
GET /v1/data/usda-food/spec1 credit

Returns FoodData Central's own OpenAPI 3.0 document: every path, every accepted parameter and the full response schemas for AbridgedFoodItem, BrandedFoodItem, FoundationFoodItem, SRLegacyFoodItem and SurveyFoodItem.

No parameters

Licence

Work of the United States federal government, not subject to copyright in the US (17 U.S.C. 105). Free to use, including commercially, with the agency named as the source.

https://fdc.nal.usda.gov/api-guide.html

Attribution

Display this wherever you show the data. It arrives on every response as provenance.attribution_text.

Source: USDA FoodData Central

Cache: up to 86400s