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/search.php?api_key=API_KEY&brand=BRAND&country=COUNTRY&page=1
Tips
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. if you aren't sure how to upgrade your subscription.
{
"type": "object",
"properties": {
"allergen": {
"type": "string"
},
"brand": {
"type": "string"
},
"category": {
"type": "string"
},
"country": {
"type": "string"
},
"diet": {
"type": "string",
"enum": [
"Vegan",
"Vegetarian",
"Gluten Free"
]
},
"ingredient": {
"type": "string"
},
"keyword": {
"type": "string"
},
"limit": {
"type": "integer",
"enum": [
1,
2,
3,
4,
5,
6,
7,
8,
9,
10
]
},
"mineral": {
"type": "string"
},
"nutrient": {
"type": "string"
},
"page": {
"type": "integer"
},
"palm_oil": {
"type": "string"
},
"trace": {
"type": "string"
},
"vitamin": {
"type": "string"
}
},
"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"
}
}
}
}
}
}
}