{
  "openapi" : "3.0.0",
  "info" : {
    "title" : "Chomp Food Database API Documentation",
    "description" : "## Important\nAn **[API key](https://chompthis.com/api/)** is required for access to this API. Get yours at **[https://chompthis.com/api](https://chompthis.com/api/)**.\n\n### Getting Started\n  * **[Subscribe](https://chompthis.com/api/#pricing)** to the API.\n  * Scroll down and click the \"**Authorize**\" button.\n  * Enter your API key into the \"**value**\" input, click the \"**Authorize**\" button, then click the \"**Close**\" button.\n  * Scroll down to the section titled \"**default**\" and click on the API endpoint you wish to use.\n  * Click the \"**Try it out**\" button.\n  * Enter the information the endpoint requires.\n  * Click the \"**Execute**\" button.\n\n### Example \n  * Branded food response object: **[View example »](https://raw.githubusercontent.com/chompfoods/examples/master/branded-food-response-object.json)**\n  * Ingredient response object: **[View example »](https://raw.githubusercontent.com/chompfoods/examples/master/ingredient-response-object.json)**\n  * Error response object: **[View example »](https://raw.githubusercontent.com/chompfoods/examples/master/error-response-object.json)**\n\n### How Do I Find My API Key?\n  * Your API key was sent to the email address you used to create your subscription.\n  * You will also find your API key in the **[Client Center](https://chompthis.com/api/manage.php)**.\n  * Read **[this article](https://desk.zoho.com/portal/chompthis/kb/articles/how-do-i-find-my-api-key)** for more information.\n\n### Helpful Links\n  * **Help & Support**\n    * [Knowledge Base »](https://desk.zoho.com/portal/chompthis/kb/chomp)\n    * [Support »](https://chompthis.com/api/ticket-new.php)\n    * [Client Center »](https://chompthis.com/api/manage.php)\n  * **Pricing**\n    * [Subscription Options »](https://chompthis.com/api/)\n    * [Cost Calculator »](https://chompthis.com/api/cost-calculator.php)\n  * **Guidelines**\n    * [Terms & License »](https://chompthis.com/api/terms.php)\n    * [Attribution »](https://chompthis.com/api/docs/attribution.php)\n",
    "version" : "1.0.0-oas3"
  },
  "paths" : {
    "/food/branded/barcode.php" : {
      "get" : {
        "summary" : "Get a branded food item using a barcode",
        "description" : "## Get data for a branded food using the food's UPC/EAN barcode.\n\n**Example** \n> ```https://chompthis.com/api/v2/food/branded/barcode.php?api_key=API_KEY&code=CODE```\n\n**Tips**\n  * Read our **[Knowledge Base article](https://desk.zoho.com/portal/chompthis/kb/articles/im-having-trouble-getting-matches-for-barcodes-what-can-id-do)** for helpful tips and tricks.\n",
        "security" : [ {
          "ApiKeyAuth" : [ ]
        } ],
        "parameters" : [ {
          "in" : "query",
          "name" : "code",
          "description" : "#### UPC/EAN barcode\n\n**Example**\n> ```&code=0842234000988```\n",
          "required" : true,
          "schema" : {
            "type" : "string"
          }
        } ],
        "responses" : {
          "200" : {
            "$ref" : "#/components/responses/200BrandedResponse"
          },
          "400" : {
            "$ref" : "#/components/responses/400Error"
          },
          "401" : {
            "$ref" : "#/components/responses/401Error"
          },
          "404" : {
            "$ref" : "#/components/responses/404Error"
          },
          "500" : {
            "$ref" : "#/components/responses/500Error"
          }
        }
      }
    },
    "/food/branded/name.php" : {
      "get" : {
        "summary" : "Get a branded food item by name",
        "description" : "## Search for branded food items by name.\n\n**Example**\n> ```https://chompthis.com/api/v2/food/branded/name.php?api_key=API_KEY&name=NAME```\n\n**Tips**\n  * Get started by using our **[food lookup tool](https://chompthis.com/api/lookup.php)**.\n\n> This API endpoint is only available to Standard and Premium API subscribers. Please consider upgrading your subscription if you are subscribed to the Limited plan. **[Read this](https://desk.zoho.com/portal/chompthis/kb/articles/can-i-upgrade-downgrade-my-subscription)** if you aren't sure how to upgrade your subscription.\n",
        "security" : [ {
          "ApiKeyAuth" : [ ]
        } ],
        "parameters" : [ {
          "in" : "query",
          "name" : "name",
          "description" : "#### Search for branded food items using a general food name keyword. This does not have to exactly match the \"official\" name for the food.\n\n**Example**\n> ```&name=Starburst```\n",
          "required" : true,
          "schema" : {
            "type" : "string"
          }
        }, {
          "in" : "query",
          "name" : "limit",
          "description" : "#### Set maximum number of records you want the API to return. The default value is \"**10**.\"\n\n**Example**\n> ```&limit=10```\n",
          "required" : false,
          "schema" : {
            "type" : "integer",
            "enum" : [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 ]
          }
        }, {
          "in" : "query",
          "name" : "page",
          "description" : "#### This is how you paginate the search result. By default, you will see the first 10 records. You must increment the page number to access the next 10 records, and so on. The default value is \"**1**.\"\n\n**Example**\n> ```&page=1```\n",
          "required" : false,
          "schema" : {
            "type" : "integer"
          }
        } ],
        "responses" : {
          "200" : {
            "$ref" : "#/components/responses/200BrandedResponse"
          },
          "400" : {
            "$ref" : "#/components/responses/400Error"
          },
          "401" : {
            "$ref" : "#/components/responses/401Error"
          },
          "404" : {
            "$ref" : "#/components/responses/404Error"
          },
          "500" : {
            "$ref" : "#/components/responses/500Error"
          }
        }
      }
    },
    "/food/branded/search.php" : {
      "get" : {
        "summary" : "Get data for branded food items using various search parameters",
        "description" : "## Search for branded food items using various parameters.\n\n**Example**\n> ```https://chompthis.com/api/v2/food/branded/search.php?api_key=API_KEY&brand=BRAND&country=COUNTRY&page=1```\n\n**Tips** \n  * Get started by using the **[Query Builder](https://chompthis.com/api/build.php)**.\n\n> This API endpoint is only available to Standard and Premium API subscribers. Please consider upgrading your subscription if you are subscribed to the Limited plan. **[Read this](https://desk.zoho.com/portal/chompthis/kb/articles/can-i-upgrade-downgrade-my-subscription)** if you aren't sure how to upgrade your subscription.\n",
        "security" : [ {
          "ApiKeyAuth" : [ ]
        } ],
        "parameters" : [ {
          "in" : "query",
          "name" : "allergen",
          "description" : "#### Filter the search to only include branded foods that contain a specific allergen.\n\n**Example**\n> ```&allergen=Peanuts```\n\n**Important Note**: This parameter cannot be used alone. It must be paired with at least 1 additional parameter.\n",
          "required" : false,
          "schema" : {
            "type" : "string"
          }
        }, {
          "in" : "query",
          "name" : "brand",
          "description" : "#### Filter the search to only include branded foods that are owned by a specific brand.\n\n**Example**\n> ```&brand=Starbucks```\n",
          "required" : false,
          "schema" : {
            "type" : "string"
          }
        }, {
          "in" : "query",
          "name" : "category",
          "description" : "#### Filter the search to only include branded foods from a specific category.\n\n**Example**\n> ```&category=Plant Based Foods```\n",
          "required" : false,
          "schema" : {
            "type" : "string"
          }
        }, {
          "in" : "query",
          "name" : "country",
          "description" : "#### Filter the search to only include branded foods that are sold in a specific country.\n\n**Example**\n> ```&country=United States```\n\n**Important Note**: This parameter cannot be used alone. It must be paired with at least 1 additional parameter.\n",
          "required" : false,
          "schema" : {
            "type" : "string"
          }
        }, {
          "in" : "query",
          "name" : "diet",
          "description" : "#### Filter the search to only include branded foods that are considered compatible with a specific diet.\n\n**Important Note**: This parameter cannot be used alone. It must be paired with at least 1 additional parameter.\n",
          "required" : false,
          "schema" : {
            "type" : "string",
            "enum" : [ "Vegan", "Vegetarian", "Gluten Free" ]
          }
        }, {
          "in" : "query",
          "name" : "ingredient",
          "description" : "#### Filter the search to only include branded foods that contain a specific ingredient.\n\n**Example**\n> ```&ingredient=Salt```\n",
          "required" : false,
          "schema" : {
            "type" : "string"
          }
        }, {
          "in" : "query",
          "name" : "keyword",
          "description" : "#### Filter the search to only include branded foods that are associated with a specific keyword.\n\n**Example**\n> ```&keyword=Organic```\n\n**Important Note**: This parameter cannot be used alone. It must be paired with at least 1 additional parameter.\n",
          "required" : false,
          "schema" : {
            "type" : "string"
          }
        }, {
          "in" : "query",
          "name" : "mineral",
          "description" : "#### Filter the search to only include branded foods that contain a specific mineral.\n\n**Example**\n> ```&mineral=Potassium```\n",
          "required" : false,
          "schema" : {
            "type" : "string"
          }
        }, {
          "in" : "query",
          "name" : "nutrient",
          "description" : "#### Filter the search to only include branded foods that contain a specific nutrient.\n\n**Example**\n> ```&nutrient=Caffeine```\n\n**Important Note**: This parameter cannot be used alone. It must be paired with at least 1 additional parameter.\n",
          "required" : false,
          "schema" : {
            "type" : "string"
          }
        }, {
          "in" : "query",
          "name" : "palm_oil",
          "description" : "#### Filter the search to only include branded foods that contain a specific ingredient made using palm oil.\n\n**Example**\n> ```&palm_oil=E160a Beta Carotene```\n",
          "required" : false,
          "schema" : {
            "type" : "string"
          }
        }, {
          "in" : "query",
          "name" : "trace",
          "description" : "### Filter the search to only include branded foods that contain a specific trace ingredient.\n\n**Example**\n> ```&trace=Tree Nuts```\n\n**Important Note**: This parameter cannot be used alone. It must be paired with at least 1 additional parameter.\n",
          "required" : false,
          "schema" : {
            "type" : "string"
          }
        }, {
          "in" : "query",
          "name" : "vitamin",
          "description" : "#### Filter the search to only include branded foods that contain a specific vitamin.\n\n**Example**\n> ```&vitamin=Biotin```\n",
          "required" : false,
          "schema" : {
            "type" : "string"
          }
        }, {
          "in" : "query",
          "name" : "limit",
          "description" : "#### Set maximum number of records you want the API to return. The default value is \"**10**.\"\n\n**Example**\n> ```&limit=10```\n",
          "required" : false,
          "schema" : {
            "type" : "integer",
            "enum" : [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 ]
          }
        }, {
          "in" : "query",
          "name" : "page",
          "description" : "#### This is how you paginate the search result. By default, you will see the first 10 records. You must increment the page number to access the next 10 records, and so on. The default value is \"**1**.\"\n\n**Example**\n> ```&page=1```\n",
          "required" : false,
          "schema" : {
            "type" : "integer"
          }
        } ],
        "responses" : {
          "200" : {
            "$ref" : "#/components/responses/200BrandedResponse"
          },
          "400" : {
            "$ref" : "#/components/responses/400Error"
          },
          "401" : {
            "$ref" : "#/components/responses/401Error"
          },
          "404" : {
            "$ref" : "#/components/responses/404Error"
          },
          "500" : {
            "$ref" : "#/components/responses/500Error"
          }
        }
      }
    },
    "/food/ingredient/search.php" : {
      "get" : {
        "summary" : "Get raw/generic food ingredient item(s)",
        "description" : "## Get data for a specific ingredient or a specific set of ingredients.\n\n**Example #1: Single Ingredient**\n> ```https://chompthis.com/api/v2/ingredient/search.php?api_key=API_KEY&find=raw broccoli```\n\n**Example #2: Set of Ingredients**\n> ```https://chompthis.com/api/v2/ingredient/search.php?api_key=API_KEY&find=raw broccoli,mashed potatoes,chicken drumstick```\n\n**Tips**\n  * Expose ingredient endpoints by using our **[food lookup tool](https://chompthis.com/api/lookup.php)**.\n\n> This API endpoint is only available to Standard and Premium API subscribers. Please consider upgrading your subscription if you are subscribed to the Limited plan. **[Read this](https://desk.zoho.com/portal/chompthis/kb/articles/can-i-upgrade-downgrade-my-subscription)** if you aren't sure how to upgrade your subscription.\n",
        "security" : [ {
          "ApiKeyAuth" : [ ]
        } ],
        "parameters" : [ {
          "in" : "query",
          "name" : "find",
          "description" : "Search our database for a single ingredient or a specific set of ingredients.\n\n**Example #1: Single Ingredient**\n> ```&find=raw broccoli```\n\n**Example #2: Set of Ingredients**\n> ```&find=raw broccoli,buttermilk waffle,mashed potatoes```\n\n**Important Notes** \n  * Comma-separated lists cannot contain more than **10 ingredients**. You must perform additional API calls if you are looking up more than 10 ingredients.\n",
          "required" : true,
          "schema" : {
            "type" : "string"
          }
        }, {
          "in" : "query",
          "name" : "limit",
          "description" : "#### Set maximum number of records you want the API to return, per search term. The default value is \"**1**.\"\n\n**Example**\n> ```&limit=3```\n",
          "required" : false,
          "schema" : {
            "type" : "integer",
            "enum" : [ 1, 2, 3 ]
          }
        } ],
        "responses" : {
          "200" : {
            "$ref" : "#/components/responses/200IngredientResponse"
          },
          "400" : {
            "$ref" : "#/components/responses/400Error"
          },
          "401" : {
            "$ref" : "#/components/responses/401Error"
          },
          "404" : {
            "$ref" : "#/components/responses/404Error"
          },
          "500" : {
            "$ref" : "#/components/responses/500Error"
          }
        }
      }
    }
  },
  "servers" : [ {
    "url" : "https://chompthis.com/api/v2",
    "description" : "Production server (uses live data)"
  } ],
  "components" : {
    "securitySchemes" : {
      "ApiKeyAuth" : {
        "type" : "apiKey",
        "in" : "query",
        "name" : "api_key"
      }
    },
    "responses" : {
      "200BrandedResponse" : {
        "description" : "**Valid** - Will return an object containing any matching foods. \n",
        "content" : {
          "application/json" : {
            "schema" : {
              "$ref" : "#/components/schemas/BrandedFoodObject"
            }
          }
        }
      },
      "200IngredientResponse" : {
        "description" : "**Valid** - Will return an object containing any matching ingredient foods. \n",
        "content" : {
          "application/json" : {
            "schema" : {
              "$ref" : "#/components/schemas/IngredientObject"
            }
          }
        }
      },
      "400Error" : {
        "description" : "**Validation error** - Invalid parameters or request.\n"
      },
      "401Error" : {
        "description" : "**Unauthorized** - Invalid API key, unauthorized access, or usage limits exceeded. ***[More information »](https://desk.zoho.com/portal/chompthis/kb/articles/what-is-a-rate-limit)***\n"
      },
      "404Error" : {
        "description" : "**Not found** - No food items were found.\n"
      },
      "500Error" : {
        "description" : "**Server error** - Internal server error, request failed, or base error. *Please **[contact us](https://chompthis.com/api/ticket-new.php)** if you see this.*\n"
      }
    },
    "schemas" : {
      "BrandedFoodObject" : {
        "type" : "object",
        "description" : "Please read the description of each field in this API response object example. By default, the value of each field is **null**. This indicates an unknown state or that no data exists.",
        "properties" : {
          "items" : {
            "type" : "array",
            "description" : "An array containing an object for each individual item returned by your API call.",
            "items" : {
              "type" : "object",
              "description" : "An object containing information for this specific item.",
              "properties" : {
                "barcode" : {
                  "type" : "string",
                  "description" : "EAN/UPC barcode"
                },
                "name" : {
                  "type" : "string",
                  "description" : "Item name as provided by brand owner or as shown on packaging"
                },
                "brand" : {
                  "type" : "string",
                  "description" : "The brand name that owns this item"
                },
                "ingredients" : {
                  "type" : "string",
                  "description" : "This food item's ingredients from greatest quantity to least"
                },
                "package" : {
                  "type" : "object",
                  "description" : "An object containing basic packaging information about this item",
                  "properties" : {
                    "quantity" : {
                      "type" : "integer",
                      "description" : "Package quantity"
                    },
                    "size" : {
                      "type" : "string",
                      "description" : "Package size"
                    }
                  }
                },
                "serving" : {
                  "type" : "object",
                  "description" : "An object containing serving information for this item",
                  "properties" : {
                    "size" : {
                      "type" : "string",
                      "description" : "Serving size"
                    },
                    "measurement_unit" : {
                      "type" : "string",
                      "description" : "Measurement unit for each serving (e.g. if measure is 3 tsp, the unit is tsp)"
                    },
                    "size_fulltext" : {
                      "type" : "string",
                      "description" : "Serving size description"
                    }
                  }
                },
                "categories" : {
                  "type" : "array",
                  "items" : {
                    "type" : "string",
                    "description" : "An array of categories for this item"
                  }
                },
                "nutrients" : {
                  "type" : "array",
                  "description" : "An array containing nutrient informatio objects for this food item",
                  "items" : {
                    "type" : "object",
                    "description" : "An object containing information for a specific nutrient found in this food item",
                    "properties" : {
                      "name" : {
                        "type" : "string",
                        "description" : "Nutrient name"
                      },
                      "per_100g" : {
                        "type" : "number",
                        "description" : "Amount of the nutrient per 100g of food"
                      },
                      "measurement_unit" : {
                        "type" : "string",
                        "description" : "The unit used for the measure of this nutrient"
                      },
                      "rank" : {
                        "type" : "integer",
                        "description" : "Nutrient rank"
                      },
                      "data_points" : {
                        "type" : "integer",
                        "description" : "Number of observations on which the value is based"
                      },
                      "description" : {
                        "type" : "string",
                        "description" : "Description of the nutrient source"
                      }
                    }
                  }
                },
                "diet_labels" : {
                  "type" : "object",
                  "description" : "An object containing this item's compatibility grades for each supported diet",
                  "properties" : {
                    "vegan" : {
                      "type" : "object",
                      "description" : "An object containing information on this item's compatibility with the Vegan diets",
                      "properties" : {
                        "name" : {
                          "type" : "string",
                          "description" : "Diet name"
                        },
                        "is_compatible" : {
                          "type" : "boolean",
                          "description" : "Boolean describing if this item is compatible with this diet"
                        },
                        "compatibility_level" : {
                          "type" : "integer",
                          "description" : "Numeric representation of how compatible this item is with this diet. Higher values indicate more compatibility"
                        },
                        "confidence" : {
                          "type" : "integer",
                          "description" : "Boolean that indicates if we are confident in how this item is graded for this diet"
                        },
                        "confidence_description" : {
                          "type" : "string",
                          "description" : "Description of our confidence that this item was graded correctly"
                        }
                      }
                    },
                    "vegetarian" : {
                      "type" : "object",
                      "description" : "An object containing information on this item's compatibility with Vegetarian diets",
                      "properties" : {
                        "name" : {
                          "type" : "string",
                          "description" : "Diet name"
                        },
                        "is_compatible" : {
                          "type" : "boolean",
                          "description" : "Boolean describing if this item is compatible with this diet"
                        },
                        "compatibility_level" : {
                          "type" : "integer",
                          "description" : "Numeric representation of how compatible this item is with this diet. Higher values indicate more compatibility"
                        },
                        "confidence" : {
                          "type" : "integer",
                          "description" : "Boolean that indicates if we are confident in how this item is graded for this diet"
                        },
                        "confidence_description" : {
                          "type" : "string",
                          "description" : "Description of our confidence that this item was graded correctly"
                        }
                      }
                    },
                    "gluten_free" : {
                      "type" : "object",
                      "description" : "An object containing information on this item's compatibility with Gluten Free diets",
                      "properties" : {
                        "name" : {
                          "type" : "string",
                          "description" : "Diet name"
                        },
                        "is_compatible" : {
                          "type" : "boolean",
                          "description" : "Boolean describing if this item is compatible with this diet"
                        },
                        "compatibility_level" : {
                          "type" : "integer",
                          "description" : "Numeric representation of how compatible this item is with this diet. Higher values indicate more compatibility"
                        },
                        "confidence" : {
                          "type" : "integer",
                          "description" : "Boolean that indicates if we are confident in how this item is graded for this diet"
                        },
                        "confidence_description" : {
                          "type" : "string",
                          "description" : "Description of our confidence that this item was graded correctly"
                        }
                      }
                    }
                  }
                },
                "diet_flags" : {
                  "type" : "array",
                  "description" : "An array of ingredient objects that were flagged while grading this item for compatibility with each diet",
                  "items" : {
                    "type" : "object",
                    "description" : "An object containing information on an individual ingredient that was flagged as potentially not being compatible with a certain diet",
                    "properties" : {
                      "ingredient" : {
                        "type" : "string",
                        "description" : "Ingredient name"
                      },
                      "ingredient_description" : {
                        "type" : "string",
                        "description" : "Description of the ingredient"
                      },
                      "diet_label" : {
                        "type" : "string",
                        "description" : "Name of the diet with which this ingredient may not be compatible"
                      },
                      "is_compatible" : {
                        "type" : "string",
                        "description" : "A description of if we believe this ingredient is compatible with the diet"
                      },
                      "compatibility_level" : {
                        "type" : "integer",
                        "description" : "A numeric representation of if we believe this ingredient is compatible with the diet. Higher values indicate more compatibility"
                      },
                      "compatibility_description" : {
                        "type" : "string",
                        "description" : "A description of how we graded this ingredient for compatibility with the diet"
                      },
                      "is_allergen" : {
                        "type" : "boolean",
                        "description" : "Boolean representing if the ingredient is a known allergen"
                      }
                    }
                  }
                },
                "packaging_photos" : {
                  "type" : "object",
                  "description" : "A object containing a collection of photos of this item's packaging",
                  "properties" : {
                    "front" : {
                      "type" : "object",
                      "description" : "An object containing photos of the front of this item's packaging",
                      "properties" : {
                        "small" : {
                          "type" : "string",
                          "description" : "Small photo of the front of this item's packaging"
                        },
                        "thumb" : {
                          "type" : "string",
                          "description" : "Thumbnail photo of the front of this item's packaging"
                        },
                        "display" : {
                          "type" : "string",
                          "description" : "Full-sized photo of the front of this item's packaging"
                        }
                      }
                    },
                    "nutrition" : {
                      "type" : "object",
                      "description" : "An object containing photos of this item's nutrition label",
                      "properties" : {
                        "small" : {
                          "type" : "string",
                          "description" : "Small photo of this item's nutrition label"
                        },
                        "thumb" : {
                          "type" : "string",
                          "description" : "Thumbnail photo of this item's nutrition label"
                        },
                        "display" : {
                          "type" : "string",
                          "description" : "Full-sized photo of this item's nutrition label"
                        }
                      }
                    },
                    "ingredients" : {
                      "type" : "object",
                      "description" : "An object containing photos of the ingredients on this item's packaging",
                      "properties" : {
                        "small" : {
                          "type" : "string",
                          "description" : "Small photo of the ingredients on this item's packaging"
                        },
                        "thumb" : {
                          "type" : "string",
                          "description" : "Thumbnail photo of the ingredients on this item's packaging"
                        },
                        "display" : {
                          "type" : "string",
                          "description" : "Full-sized photo of the ingredients on this item's packaging"
                        }
                      }
                    }
                  }
                },
                "allergens" : {
                  "type" : "array",
                  "description" : "An array of ingredients in this item that may cause allergic reactions in people",
                  "items" : {
                    "type" : "string"
                  }
                },
                "brand_list" : {
                  "type" : "array",
                  "description" : "An array of brands we have associated with this item. Some items are sold by more than 1 brand.",
                  "items" : {
                    "type" : "string"
                  }
                },
                "countries" : {
                  "type" : "array",
                  "description" : "An array of countries where this item is sold",
                  "items" : {
                    "type" : "string"
                  }
                },
                "country_details" : {
                  "type" : "object",
                  "description" : "An object containing additional information on the countries where this item is found",
                  "properties" : {
                    "english_speaking" : {
                      "type" : "integer",
                      "description" : "The number of countries where English is the country's primary language"
                    },
                    "non_english_speaking" : {
                      "type" : "integer",
                      "description" : "The number of countries where English is not the country's primary language"
                    }
                  }
                },
                "palm_oil_ingredients" : {
                  "type" : "array",
                  "description" : "An array of ingredients made from palm oil",
                  "items" : {
                    "type" : "string"
                  }
                },
                "ingredient_list" : {
                  "type" : "array",
                  "description" : "An array of this item's ingredients",
                  "items" : {
                    "type" : "string"
                  }
                },
                "has_english_ingredients" : {
                  "type" : "boolean",
                  "description" : "A boolean indicating if we have English ingredients for this item"
                },
                "minerals" : {
                  "type" : "array",
                  "description" : "An array of minerals that this item contains",
                  "items" : {
                    "type" : "string"
                  }
                },
                "traces" : {
                  "type" : "array",
                  "description" : "An array of trace ingredients that may be found in this item",
                  "items" : {
                    "type" : "string"
                  }
                },
                "vitamins" : {
                  "type" : "array",
                  "description" : "An array of vitamins that are found in this item",
                  "items" : {
                    "type" : "string"
                  }
                },
                "description" : {
                  "type" : "string",
                  "description" : "A description of this item"
                },
                "keywords" : {
                  "type" : "array",
                  "description" : "An array of keywords that can be used to describe this item",
                  "items" : {
                    "type" : "string"
                  }
                }
              }
            }
          }
        }
      },
      "IngredientObject" : {
        "type" : "object",
        "description" : "Please read the description of each field in this API response object example. By default, the value of each field is **null**. This indicates an unknown state or that no data exists.",
        "properties" : {
          "items" : {
            "type" : "array",
            "description" : "An array containing an object for each individual item returned by your API call.",
            "items" : {
              "type" : "object",
              "description" : "An object containing information for this specific item.",
              "properties" : {
                "name" : {
                  "type" : "string",
                  "description" : "Item name as provided by brand owner or as shown on packaging"
                },
                "categories" : {
                  "type" : "array",
                  "items" : {
                    "type" : "string",
                    "description" : "An array of categories for this item"
                  }
                },
                "nutrients" : {
                  "type" : "array",
                  "description" : "An array containing nutrient informatio objects for this food item",
                  "items" : {
                    "type" : "object",
                    "description" : "An object containing information for a specific nutrient found in this food item",
                    "properties" : {
                      "name" : {
                        "type" : "string",
                        "description" : "Nutrient name"
                      },
                      "per_100g" : {
                        "type" : "number",
                        "description" : "Amount of the nutrient per 100g of food"
                      },
                      "measurement_unit" : {
                        "type" : "string",
                        "description" : "The unit used for the measure of this nutrient"
                      },
                      "min" : {
                        "type" : "number",
                        "description" : "Minimum nutrient value"
                      },
                      "max" : {
                        "type" : "number",
                        "description" : "Maximum nutrient value"
                      },
                      "median" : {
                        "type" : "number",
                        "description" : "Median nutrient value"
                      },
                      "rank" : {
                        "type" : "integer",
                        "description" : "Nutrient rank"
                      },
                      "data_points" : {
                        "type" : "integer",
                        "description" : "Number of observations on which the value is based"
                      },
                      "footnote" : {
                        "type" : "string",
                        "description" : "Comments on any unusual aspect of the food nutrient. Examples might include why a nutrient value is different than typically expected."
                      },
                      "description" : {
                        "type" : "string",
                        "description" : "Description of the nutrient source"
                      }
                    }
                  }
                },
                "calorie_conversion_factor" : {
                  "type" : "object",
                  "description" : "An object containing the multiplication factors to be used when calculating energy from macronutrients for a specific food.",
                  "properties" : {
                    "protein_value" : {
                      "type" : "number",
                      "description" : "The multiplication factor for protein"
                    },
                    "fat_value" : {
                      "type" : "number",
                      "description" : "The multiplication factor for fat"
                    },
                    "carbohydrate_value" : {
                      "type" : "number",
                      "description" : "The multiplication factor for carbohydrates"
                    }
                  }
                },
                "protein_conversion_factor" : {
                  "type" : "number",
                  "description" : "The multiplication factor used to calculate protein from nitrogen"
                },
                "components" : {
                  "type" : "array",
                  "description" : "An array of objects containing the constituent parts of a food (e.g. bone is a component of meat)",
                  "items" : {
                    "type" : "object",
                    "description" : "An object containing information on a specific component of this food item",
                    "properties" : {
                      "name" : {
                        "type" : "string",
                        "description" : "The kind of component, e.g. bone"
                      },
                      "pct_weight" : {
                        "type" : "number",
                        "description" : "The weight of the component as a percentage of the total weight of the food"
                      },
                      "gram_weight" : {
                        "type" : "number",
                        "description" : "The weight of the component in grams"
                      },
                      "is_refuse" : {
                        "type" : "boolean",
                        "description" : "Whether the component is refuse, i.e. not edible"
                      },
                      "data_points" : {
                        "type" : "integer",
                        "description" : "The number of obersvations on which the measure is based"
                      }
                    }
                  }
                },
                "portions" : {
                  "type" : "array",
                  "description" : "An array of objects containing information on discrete amounts of a food found in this item",
                  "items" : {
                    "type" : "object",
                    "description" : "An object containing information on a specific food portion found in this item",
                    "properties" : {
                      "measurement_unit" : {
                        "type" : "string",
                        "description" : "The unit used for measure (e.g. if mesure is 3 tsp, the unit is tsp)"
                      },
                      "description" : {
                        "type" : "string",
                        "description" : "Comments that provide more specificity on the measure. For example, for a pizza measure the dissemination text might be 1 slice is 1/8th of a 14 inch pizza."
                      },
                      "modifier" : {
                        "type" : "string",
                        "description" : "Qualifier of the measure (e.g. related to food shape or form) (e.g. melted, crushed, diced)"
                      },
                      "gram_weight" : {
                        "type" : "number",
                        "description" : "The weight of the measure in grams"
                      },
                      "data_points" : {
                        "type" : "integer",
                        "description" : "The number of observations on which the measure is based"
                      },
                      "footnote" : {
                        "type" : "string",
                        "description" : "Comments on any unusual aspects of the measure. Examples might includes caveats on the usage of a measure, or reasons why a measure gram weight is an unexpected value."
                      }
                    }
                  }
                },
                "common_name" : {
                  "type" : "string",
                  "description" : "Common name associated with this item. These generally clarify what the item is (e.g. when the brand name is \"BRAND's Spicy Enchilada\" the common name may be \"Chicken enchilada\")"
                },
                "footnote" : {
                  "type" : "string",
                  "description" : "Comments on any unusual aspects of this item. Examples might include unusual aspects of the food overall"
                },
                "search_term" : {
                  "type" : "string",
                  "description" : "The original search term that found this food item"
                },
                "score" : {
                  "type" : "string",
                  "description" : "A value that represents how similar the name of this food item is to the original search term. The lower the value the closer this item's name is to the original search term."
                }
              }
            }
          }
        }
      }
    }
  }
}