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"
        }
      }
    ]
  }
}