USDA · Example Payload

Usda Fooddata Central Food Item Example

Example response from the FoodData Central /v1/food/{fdcId} endpoint for a branded food item

AgricultureFood SafetyNutritionStatisticsGeospatialMarket NewsFederal-Government

Usda Fooddata Central Food Item Example is an example object payload from USDA, with 3 top-level fields. It illustrates the shape of data this provider's APIs accept or return.

Top-level fields

descriptionendpointresponse

Example Payload

Raw ↑
{
  "description": "Example response from the FoodData Central /v1/food/{fdcId} endpoint for a branded food item",
  "endpoint": "GET https://api.nal.usda.gov/fdc/v1/food/534358?api_key=DEMO_KEY",
  "response": {
    "fdcId": 534358,
    "availableDate": "8/18/2018",
    "brandOwner": "Kar Nut Products Company",
    "dataSource": "LI",
    "dataType": "Branded",
    "description": "NUT 'N BERRY MIX",
    "foodClass": "Branded",
    "gtinUpc": "077034085228",
    "householdServingFullText": "1 ONZ",
    "ingredients": "PEANUTS (PEANUTS, PEANUT AND/OR SUNFLOWER OIL). RAISINS. DRIED CRANBERRIES (CRANBERRIES, SUGAR, SUNFLOWER OIL). SUNFLOWER KERNELS AND ALMONDS (SUNFLOWER KERNELS AND ALMONDS, PEANUT AND/OR SUNFLOWER OIL).",
    "modifiedDate": "8/18/2018",
    "publicationDate": "4/1/2019",
    "servingSize": 28,
    "servingSizeUnit": "g",
    "brandedFoodCategory": "Popcorn, Peanuts, Seeds & Related Snacks",
    "labelNutrients": {
      "fat": { "value": 8.9992 },
      "saturatedFat": { "value": 0.9996 },
      "transFat": { "value": 0 },
      "cholesterol": { "value": 0 },
      "sodium": { "value": 0 },
      "carbohydrates": { "value": 12.0008 },
      "fiber": { "value": 1.988 },
      "sugars": { "value": 7.9996 },
      "protein": { "value": 4.0012 },
      "calcium": { "value": 19.88 },
      "iron": { "value": 0.7196 },
      "postassium": { "value": 159.88 },
      "calories": { "value": 140 }
    },
    "foodNutrients": [
      {
        "id": 1985493,
        "amount": 140,
        "type": "FoodNutrient",
        "nutrient": {
          "id": 1008,
          "number": "208",
          "name": "Energy",
          "rank": 300,
          "unitName": "kcal"
        },
        "foodNutrientDerivation": {
          "id": 60,
          "code": "LCCS",
          "description": "Calculated from value per serving size measure",
          "foodNutrientSource": {
            "id": 9,
            "code": "12",
            "description": "Manufacturer's analytical; partial documentation"
          }
        }
      },
      {
        "id": 1985494,
        "amount": 8.9992,
        "type": "FoodNutrient",
        "nutrient": {
          "id": 1004,
          "number": "204",
          "name": "Total lipid (fat)",
          "rank": 800,
          "unitName": "g"
        }
      },
      {
        "id": 1985495,
        "amount": 4.0012,
        "type": "FoodNutrient",
        "nutrient": {
          "id": 1003,
          "number": "203",
          "name": "Protein",
          "rank": 600,
          "unitName": "g"
        }
      },
      {
        "id": 1985496,
        "amount": 12.0008,
        "type": "FoodNutrient",
        "nutrient": {
          "id": 1005,
          "number": "205",
          "name": "Carbohydrate, by difference",
          "rank": 1110,
          "unitName": "g"
        }
      }
    ]
  }
}

Work with this as data

Every example here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for examples

4 MCP tools reach this
  • find_examplesBrowse and filter every example in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This example
curl "https://apis.io/api/v1/examples/usda-fooddata-central-food-item-example"
All examples
curl "https://apis.io/api/v1/examples?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.