United States Department of Agriculture · Schema

USDA FoodData Central Food Item

Schema for a food item from the USDA FoodData Central database

Federal GovernmentAgricultureFood SafetyNutritionRural DevelopmentClimate

Properties

Name Type Description
fdcId integer FoodData Central unique identifier
description string Food item description
dataType string Food data type source
publicationDate string Date the food item was published in FDC
brandOwner string Brand owner for branded food items
gtinUpc string GTIN or UPC barcode for branded items
foodCategory string USDA food category
foodNutrients array Nutrient values per 100g of food
servingSize number Serving size amount
servingSizeUnit string Unit for serving size
View JSON Schema on GitHub

JSON Schema

usda-fdc-food-item-schema.json Raw ↑ 
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/united-states-department-of-agriculture/main/json-schema/usda-fdc-food-item-schema.json",
  "title": "USDA FoodData Central Food Item",
  "description": "Schema for a food item from the USDA FoodData Central database",
  "type": "object",
  "properties": {
    "fdcId": {
      "type": "integer",
      "description": "FoodData Central unique identifier"
    },
    "description": {
      "type": "string",
      "description": "Food item description"
    },
    "dataType": {
      "type": "string",
      "description": "Food data type source",
      "enum": ["Foundation", "SR Legacy", "Branded", "Survey (FNDDS)", "Experimental"]
    },
    "publicationDate": {
      "type": "string",
      "format": "date",
      "description": "Date the food item was published in FDC"
    },
    "brandOwner": {
      "type": "string",
      "description": "Brand owner for branded food items"
    },
    "gtinUpc": {
      "type": "string",
      "description": "GTIN or UPC barcode for branded items"
    },
    "foodCategory": {
      "type": "string",
      "description": "USDA food category"
    },
    "foodNutrients": {
      "type": "array",
      "description": "Nutrient values per 100g of food",
      "items": {
        "type": "object",
        "properties": {
          "nutrientId": {"type": "integer"},
          "nutrientName": {"type": "string"},
          "nutrientNumber": {"type": "string"},
          "unitName": {"type": "string"},
          "value": {"type": "number"}
        }
      }
    },
    "servingSize": {
      "type": "number",
      "description": "Serving size amount"
    },
    "servingSizeUnit": {
      "type": "string",
      "description": "Unit for serving size"
    }
  },
  "required": ["fdcId", "description", "dataType"]
}