What a response looks like
{"count": 20, "truncated": false, "items": [ … ]}What it returns
Nutrition facts for 450,000+ branded grocery products plus USDA reference foods, from USDA FoodData Central.
- UPC lookup: scan a barcode, get the product's nutrition label and ingredients.
- Search by product name, brand or category; filter by calories, protein, sugars, sodium, fat, carbs and fiber; include or exclude ingredients (e.g. no corn syrup, no peanuts).
- Generic foods ("apples, raw", "hummus") from the Foundation and SR Legacy reference sets.
fdcId, source (branded or generic), description, brandOwner, brandName, upc, category, ingredients, servingSize, servingUnit, householdServing, packageWeight, per100 (calories, protein, fat, saturated and trans fat, cholesterol, carbs, fiber, sugars, added sugars, sodium, potassium, calcium, iron, vitamins C and D per 100 g/ml), perServing for branded products, and the USDA page url.
Discontinued products are excluded, and each UPC appears once (its newest label).
Request
POST https://api.pushbuild.com/usda-food-nutrition/run with a JSON body. Send your key in the X-API-Key header.
| Field | Type | Description |
|---|---|---|
query | string | Food or product name words, e.g. greek yogurt, cheerios. |
upcs | list of strings | Look up packaged products by UPC/GTIN barcode (leading zeros optional). |
brands | list of strings | Brand or brand-owner name text, e.g. Kellogg, Chobani. |
categories | list of strings | Category text, e.g. Cereal, Snacks, Fruits. |
sources | list of strings | branded (packaged products) or generic (USDA reference foods like 'apples, raw'). Default both. |
ingredientsInclude | list of strings | Every listed ingredient must appear, e.g. oats. |
ingredientsExclude | list of strings | None of these may appear, e.g. corn syrup, peanut. |
maxCalories | integer | Upper limit on kcal per 100 g or ml. |
minProtein | integer | Lower limit on protein grams per 100 g or ml. |
maxSugars | integer | Upper limit on total sugars per 100 g or ml. |
maxSodium | integer | Upper limit on sodium mg per 100 g or ml. |
maxFat | integer | Upper limit on total fat per 100 g or ml. |
maxCarbs | integer | Upper limit on carbohydrates per 100 g or ml. |
minFiber | integer | Lower limit on fiber per 100 g or ml. |
sortBy | string: relevance, calories, protein, sugars, sodium, fiber, newest | Result order (nutrient sorts are per 100 g). Default: "relevance". |
maxItems | integer | Maximum items to return (1-500). Default: 100. |
Example
curl -X POST https://api.pushbuild.com/usda-food-nutrition/run \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "greek yogurt", "maxItems": 20}'
Response
{"count": 20, "truncated": false, "seconds": 1.4, "items": [ { ... } ]}
Each call returns up to 500 items. Records that fail validation or are not found are flagged in the items and not charged.
Pricing
Pay only for results returned: $0.24 per 1,000 foods. No charge for errors or empty searches.
| Foods | Cost |
|---|---|
| 1,000 | $0.24 |
| 10,000 | $2.40 |
| 100,000 | $24.00 |
| 1,000,000 | $240.00 |
| 4,166 a month | Free ($1 monthly credit) |
Use it from Claude, ChatGPT or Cursor
This API is also an MCP server: https://api.pushbuild.com/mcp/usda-food-nutrition. Add it to any assistant that supports remote MCP servers, with your key in the X-API-Key header. Same prices. Setup for each app.
Tell us what you need built.
Questions about this API, higher volumes, or a data source you need that we don't cover yet.
hello@pushbuild.comWant this data inside your own app or CRM? API integrations and data sync