Get data for a branded food using the food's UPC/EAN barcode.
Example
https://chompthis.com/api/v2/food/branded/barcode.php?api_key=API_KEY&code=CODE
Tips
- Read our for helpful tips and tricks.
643 matches
4 actions
Chomp Food Database API Documentation
4 actions
Other/Chomp Food Database API Documentation
Example
https://chompthis.com/api/v2/food/branded/barcode.php?api_key=API_KEY&code=CODE
Tips
{
"type": "object",
"properties": {
"code": {
"type": "string"
}
},
"required": [
"code"
],
"additionalProperties": false
}{
"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": {
"allergens": {
"type": "array",
"description": "An array of ingredients in this item that may cause allergic reactions in people",
"items": {
"type": "string"
}
},
"barcode": {
"type": "string",
"description": "EAN/UPC barcode"
},
"brand": {
"type": "string",
"description": "The brand name that owns this item"
},
"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"
}
},
"categories": {
"type": "array",
"items": {
"type": "string",
"description": "An array of categories for this item"
}
},
"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"
}
}
},
"description": {
"type": "string",
"description": "A description of this item"
},
"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": {
"compatibility_description": {
"type": "string",
"description": "A description of how we graded this ingredient for compatibility 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"
},
"diet_label": {
"type": "string",
"description": "Name of the diet with which this ingredient may not be compatible"
},
"ingredient": {
"type": "string",
"description": "Ingredient name"
},
"ingredient_description": {
"type": "string",
"description": "Description of the ingredient"
},
"is_allergen": {
"type": "boolean",
"description": "Boolean representing if the ingredient is a known allergen"
},
"is_compatible": {
"type": "string",
"description": "A description of if we believe this ingredient is compatible with the diet"
}
}
}
},
"diet_labels": {
"type": "object",
"description": "An object containing this item's compatibility grades for each supported diet",
"properties": {
"gluten_free": {
"type": "object",
"description": "An object containing information on this item's compatibility with Gluten Free diets",
"properties": {
"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"
},
"is_compatible": {
"type": "boolean",
"description": "Boolean describing if this item is compatible with this diet"
},
"name": {
"type": "string",
"description": "Diet name"
}
}
},
"vegan": {
"type": "object",
"description": "An object containing information on this item's compatibility with the Vegan diets",
"properties": {
"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"
},
"is_compatible": {
"type": "boolean",
"description": "Boolean describing if this item is compatible with this diet"
},
"name": {
"type": "string",
"description": "Diet name"
}
}
},
"vegetarian": {
"type": "object",
"description": "An object containing information on this item's compatibility with Vegetarian diets",
"properties": {
"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"
},
"is_compatible": {
"type": "boolean",
"description": "Boolean describing if this item is compatible with this diet"
},
"name": {
"type": "string",
"description": "Diet name"
}
}
}
}
},
"has_english_ingredients": {
"type": "boolean",
"description": "A boolean indicating if we have English ingredients for this item"
},
"ingredient_list": {
"type": "array",
"description": "An array of this item's ingredients",
"items": {
"type": "string"
}
},
"ingredients": {
"type": "string",
"description": "This food item's ingredients from greatest quantity to least"
},
"keywords": {
"type": "array",
"description": "An array of keywords that can be used to describe this item",
"items": {
"type": "string"
}
},
"minerals": {
"type": "array",
"description": "An array of minerals that this item contains",
"items": {
"type": "string"
}
},
"name": {
"type": "string",
"description": "Item name as provided by brand owner or as shown on packaging"
},
"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": {
"data_points": {
"type": "integer",
"description": "Number of observations on which the value is based"
},
"description": {
"type": "string",
"description": "Description of the nutrient source"
},
"measurement_unit": {
"type": "string",
"description": "The unit used for the measure of this nutrient"
},
"name": {
"type": "string",
"description": "Nutrient name"
},
"per_100g": {
"type": "number",
"description": "Amount of the nutrient per 100g of food"
},
"rank": {
"type": "integer",
"description": "Nutrient rank"
}
}
}
},
"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"
}
}
},
"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": {
"display": {
"type": "string",
"description": "Full-sized photo of the front of this item's packaging"
},
"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"
}
}
},
"ingredients": {
"type": "object",
"description": "An object containing photos of the ingredients on this item's packaging",
"properties": {
"display": {
"type": "string",
"description": "Full-sized photo of the ingredients on this item's packaging"
},
"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"
}
}
},
"nutrition": {
"type": "object",
"description": "An object containing photos of this item's nutrition label",
"properties": {
"display": {
"type": "string",
"description": "Full-sized photo of this item's nutrition label"
},
"small": {
"type": "string",
"description": "Small photo of this item's nutrition label"
},
"thumb": {
"type": "string",
"description": "Thumbnail photo of this item's nutrition label"
}
}
}
}
},
"palm_oil_ingredients": {
"type": "array",
"description": "An array of ingredients made from palm oil",
"items": {
"type": "string"
}
},
"serving": {
"type": "object",
"description": "An object containing serving information for this item",
"properties": {
"measurement_unit": {
"type": "string",
"description": "Measurement unit for each serving (e.g. if measure is 3 tsp, the unit is tsp)"
},
"size": {
"type": "string",
"description": "Serving size"
},
"size_fulltext": {
"type": "string",
"description": "Serving size description"
}
}
},
"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"
}
}
}
}
}
}
}