Nutritionix · Schema

Food

A fully detailed food object with complete nutrient information.

RestaurantHealthNutritionFoodFitnessPublic APIs

Properties

Name Type Description
food_name string
brand_name string
serving_qty number
serving_unit string
serving_weight_grams number
nf_calories number
nf_total_fat number
nf_saturated_fat number
nf_cholesterol number
nf_sodium number
nf_total_carbohydrate number
nf_dietary_fiber number
nf_sugars number
nf_protein number
nf_potassium number
nf_p number
full_nutrients array Complete list of nutrient values keyed by USDA attribute id.
nix_brand_name string
nix_brand_id string
nix_item_name string
nix_item_id string
metadata object
source integer Internal source identifier for the food record.
ndb_no integer USDA National Nutrient Database number for common foods.
tags object
alt_measures array Alternative serving measures for the food.
photo object
View JSON Schema on GitHub

JSON Schema

track-food-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/nutritionix/refs/heads/main/json-schema/track-food-schema.json",
  "title": "Food",
  "description": "A fully detailed food object with complete nutrient information.",
  "type": "object",
  "properties": {
    "food_name": {
      "type": "string",
      "example": "Big Mac"
    },
    "brand_name": {
      "type": "string",
      "nullable": true,
      "example": "McDonald's"
    },
    "serving_qty": {
      "type": "number",
      "example": 1
    },
    "serving_unit": {
      "type": "string",
      "example": "burger"
    },
    "serving_weight_grams": {
      "type": "number",
      "nullable": true,
      "example": 219
    },
    "nf_calories": {
      "type": "number",
      "example": 540
    },
    "nf_total_fat": {
      "type": "number",
      "example": 28
    },
    "nf_saturated_fat": {
      "type": "number",
      "example": 10
    },
    "nf_cholesterol": {
      "type": "number",
      "example": 80
    },
    "nf_sodium": {
      "type": "number",
      "example": 970
    },
    "nf_total_carbohydrate": {
      "type": "number",
      "example": 47
    },
    "nf_dietary_fiber": {
      "type": "number",
      "nullable": true,
      "example": 3
    },
    "nf_sugars": {
      "type": "number",
      "nullable": true,
      "example": 9
    },
    "nf_protein": {
      "type": "number",
      "example": 25
    },
    "nf_potassium": {
      "type": "number",
      "nullable": true
    },
    "nf_p": {
      "type": "number",
      "nullable": true
    },
    "full_nutrients": {
      "type": "array",
      "description": "Complete list of nutrient values keyed by USDA attribute id.",
      "items": {
        "$ref": "#/components/schemas/FullNutrient"
      }
    },
    "nix_brand_name": {
      "type": "string",
      "nullable": true,
      "example": "McDonald's"
    },
    "nix_brand_id": {
      "type": "string",
      "nullable": true,
      "example": "513fbc1283aa2dc80c000053"
    },
    "nix_item_name": {
      "type": "string",
      "nullable": true,
      "example": "Big Mac"
    },
    "nix_item_id": {
      "type": "string",
      "nullable": true,
      "example": "513fc9e73fe3ffd40300109f"
    },
    "metadata": {
      "type": "object",
      "additionalProperties": true
    },
    "source": {
      "type": "integer",
      "description": "Internal source identifier for the food record.",
      "example": 8
    },
    "ndb_no": {
      "type": "integer",
      "nullable": true,
      "description": "USDA National Nutrient Database number for common foods."
    },
    "tags": {
      "type": "object",
      "nullable": true,
      "additionalProperties": true
    },
    "alt_measures": {
      "type": "array",
      "nullable": true,
      "description": "Alternative serving measures for the food.",
      "items": {
        "$ref": "#/components/schemas/AltMeasure"
      }
    },
    "photo": {
      "$ref": "#/components/schemas/Photo"
    }
  }
}