Branded Foods Search
The brandedFoods
query search for foods that belongs to a brand and/or have a barcode.
Branded foods are known as all the foods that belong to a brand and include a trademark and a barcode. For example "Oreo
", "Hershey
", "Mazola
", "McCormick
", etc. Find the list of brand foods on this page.
Characteristics
Within the branded food search you are able to:
Get the nutritional information for a specific food
Use pagination
Add a specific brand food barcode as an argument
Filter the information to retrieve the following results
ID
Tags
Nutrients
Name
Ingredients
Meal Time
Barcode
How to calculate the nutrient according to a food portion
Branded Foods are per each 100g.
. For instance, each nutrient corresponds to 100g
. To calculate the nutrients, use the following equation:
Where:
weight
is equivalent to theservingSize
Available Arguments
Argument
Type
Description
query
Query
Name or keyword of the food. It is possible to add more than one value. The query is case insensitive.
first
String
Retrieves the first results from the list.
filter
Object that filters food according to different criteria. Use this object to filter:
Tags
Nutrients
Available Fields
Field Name
Type
Description
id
ID
Id of the food
brandedFoodCategory
String
The type of food. i.e. vegetables, fruit, snack, etc.
brandOwner
String
Name of the food brand owner
calories
Int
Number of calories
description
String
Branded food description
gtinUpc
String
householdServingFulltext
String
Name of the serving
name
String
Name of the food
nutrients
Object that includes the information of the nutrients available in the food
servingSize
Int
Quantity of grams per serving
ServingSizeUnit
Int
Unit of the Serving size
tags
String
Pagination
The brandedFoods
query supports the use of pagination. The following fields can be used
pageInfo{
hasNextPage
hasPreviousPage
startCursor
endCursor
}
Examples
Get the nutritional information of a specific food
{
brandedFoods(
filter: {
id: "QnJhbmRlZEZvb2ROb2RlOjg4MzE2OTZlLWJiMWItNDhkYi1iMmZjLWRmMzI1YjQ1NDY5OA=="
}
) {
edges {
node {
id
name
description
gtinUpc
brandOwner
servingSize
servingSizeUnit
nutrients {
type
amount
name
unit
}
}
}
}
}
{
"data": {
"brandedFoods": {
"edges": [
{
"node": {
"id": "QnJhbmRlZEZvb2ROb2RlOjg4MzE2OTZlLWJiMWItNDhkYi1iMmZjLWRmMzI1YjQ1NDY5OA==",
"name": "Oreo oreo popcorn",
"description": "OREO POPCORN, OREO",
"gtinUpc": "814109021343",
"brandOwner": "Perfect Snax Prime, LLC",
"servingSize": 30,
"servingSizeUnit": "g",
"nutrients": [
{
"type": "PROTEIN",
"amount": 3.33,
"name": "Protein",
"unit": "G"
},
{
"type": "FAT",
"amount": 26.67,
"name": "Total lipid (fat)",
"unit": "G"
},
{
"type": "CARBOHYDRATE_BY_SUMMATION",
"amount": 63.33,
"name": "Carbohydrate, by summation",
"unit": "G"
},
{
"type": "CARBS",
"amount": 63.33,
"name": "Carbohydrate, by difference",
"unit": "G"
},
{
"type": "ENERGY",
"amount": 33,
"name": "Energy",
"unit": "KCAL"
},
{
"type": "SUGARS_TOTAL_INCLUDING_NLEA",
"amount": 40,
"name": "Sugars, total including NLEA",
"unit": "G"
},
{
"type": "SUGARS_TOTAL_NLEA",
"amount": 40,
"name": "Sugars, Total NLEA",
"unit": "G"
},
{
"type": "FIBER_TOTAL_DIETARY",
"amount": 6.7,
"name": "Fiber, total dietary",
"unit": "G"
},
{
"type": "CALCIUM_CA",
"amount": 50,
"name": "Calcium, Ca",
"unit": "MG"
},
{
"type": "IRON_FE",
"amount": 0,
"name": "Iron, Fe",
"unit": "MG"
},
{
"type": "POTASSIUM_K",
"amount": 80,
"name": "Potassium, K",
"unit": "MG"
},
{
"type": "SODIUM_NA",
"amount": 83,
"name": "Sodium, Na",
"unit": "MG"
},
{
"type": "VITAMIN_D_D2_D3_INTERNATIONAL_UNITS",
"amount": 0,
"name": "Vitamin D (D2 + D3), International Units",
"unit": "IU"
},
{
"type": "SUGARS_ADDED",
"amount": 60,
"name": "Sugars, added",
"unit": "G"
},
{
"type": "CHOLESTEROL",
"amount": 0,
"name": "Cholesterol",
"unit": "MG"
},
{
"type": "FATTY_ACIDS_TOTAL_TRANS",
"amount": 0,
"name": "Fatty acids, total trans",
"unit": "G"
},
{
"type": "FATTY_ACIDS_TOTAL_SATURATED",
"amount": 11.67,
"name": "Fatty acids, total saturated",
"unit": "G"
}
]
}
}
]
}
}
}
Get the list of recipes that contains "oreo"
The following example searches all the foods that contain oreo
in it
{
brandedFoods(query: "oreo", first: 2) {
edges {
node {
id
name
gtinUpc
brandOwner
servingSize
servingSizeUnit
brandedFoodCategory
nutrients {
type
amount
name
unit
}
}
}
}
}
{
"data": {
"brandedFoods": {
"edges": [
{
"node": {
"id": "QnJhbmRlZEZvb2ROb2RlOjg4MzE2OTZlLWJiMWItNDhkYi1iMmZjLWRmMzI1YjQ1NDY5OA==",
"name": "Oreo oreo popcorn",
"gtinUpc": "814109021343",
"brandOwner": "Perfect Snax Prime, LLC",
"servingSize": 30,
"servingSizeUnit": "g",
"brandedFoodCategory": "Popcorn, Peanuts, Seeds & Related Snacks",
"nutrients": [
{
"type": "PROTEIN",
"amount": 3.33,
"name": "Protein",
"unit": "G"
},
{
"type": "FAT",
"amount": 26.67,
"name": "Total lipid (fat)",
"unit": "G"
},
{
"type": "CARBOHYDRATE_BY_SUMMATION",
"amount": 63.33,
"name": "Carbohydrate, by summation",
"unit": "G"
},
{
"type": "CARBS",
"amount": 63.33,
"name": "Carbohydrate, by difference",
"unit": "G"
},
{
"type": "ENERGY",
"amount": 33,
"name": "Energy",
"unit": "KCAL"
},
{
"type": "SUGARS_TOTAL_INCLUDING_NLEA",
"amount": 40,
"name": "Sugars, total including NLEA",
"unit": "G"
},
{
"type": "SUGARS_TOTAL_NLEA",
"amount": 40,
"name": "Sugars, Total NLEA",
"unit": "G"
},
{
"type": "FIBER_TOTAL_DIETARY",
"amount": 6.7,
"name": "Fiber, total dietary",
"unit": "G"
},
{
"type": "CALCIUM_CA",
"amount": 50,
"name": "Calcium, Ca",
"unit": "MG"
},
{
"type": "IRON_FE",
"amount": 0,
"name": "Iron, Fe",
"unit": "MG"
},
{
"type": "POTASSIUM_K",
"amount": 80,
"name": "Potassium, K",
"unit": "MG"
},
{
"type": "SODIUM_NA",
"amount": 83,
"name": "Sodium, Na",
"unit": "MG"
},
{
"type": "VITAMIN_D_D2_D3_INTERNATIONAL_UNITS",
"amount": 0,
"name": "Vitamin D (D2 + D3), International Units",
"unit": "IU"
},
{
"type": "SUGARS_ADDED",
"amount": 60,
"name": "Sugars, added",
"unit": "G"
},
{
"type": "CHOLESTEROL",
"amount": 0,
"name": "Cholesterol",
"unit": "MG"
},
{
"type": "FATTY_ACIDS_TOTAL_TRANS",
"amount": 0,
"name": "Fatty acids, total trans",
"unit": "G"
},
{
"type": "FATTY_ACIDS_TOTAL_SATURATED",
"amount": 11.67,
"name": "Fatty acids, total saturated",
"unit": "G"
}
]
}
},
{
"node": {
"id": "QnJhbmRlZEZvb2ROb2RlOjVlNDMyM2Y0LWQ3ZTItNDkyMi04NjRiLTYzZGZiYzg4OTIxMg==",
"name": "Oreo oreo flavored candy canes",
"gtinUpc": "030800837001",
"brandOwner": "Spangler Candy Company",
"servingSize": 12,
"servingSizeUnit": "g",
"brandedFoodCategory": "Candy",
"nutrients": [
{
"type": "PROTEIN",
"amount": 0,
"name": "Protein",
"unit": "G"
},
{
"type": "FAT",
"amount": 0,
"name": "Total lipid (fat)",
"unit": "G"
},
{
"type": "CARBOHYDRATE_BY_SUMMATION",
"amount": 100,
"name": "Carbohydrate, by summation",
"unit": "G"
},
{
"type": "CARBS",
"amount": 100,
"name": "Carbohydrate, by difference",
"unit": "G"
},
{
"type": "ENERGY",
"amount": 375,
"name": "Energy",
"unit": "KCAL"
},
{
"type": "SUGARS_TOTAL_INCLUDING_NLEA",
"amount": 75,
"name": "Sugars, total including NLEA",
"unit": "G"
},
{
"type": "SUGARS_TOTAL_NLEA",
"amount": 75,
"name": "Sugars, Total NLEA",
"unit": "G"
},
{
"type": "SODIUM_NA",
"amount": 83,
"name": "Sodium, Na",
"unit": "MG"
},
{
"type": "SUGARS_ADDED",
"amount": 75,
"name": "Sugars, added",
"unit": "G"
}
]
}
}
]
}
}
}
Get the list of milk recipes with a specific Barcode
Without using query variables
{
brandedFoods(barcode: "763528339136")
{
edges {
node {
id
name
gtinUpc
brandOwner
servingSize
servingSizeUnit
nutrients {
type
amount
name
unit
}
}
}
}
}
{
"data": {
"brandedFoods": {
"edges": [
{
"node": {
"id": "QnJhbmRlZEZvb2ROb2RlOjQ3OTk0MQ==",
"name": "Milk",
"gtinUpc": "763528339136",
"brandOwner": "Promised Land Dairy",
"servingSize": 240,
"servingSizeUnit": "ml",
"nutrients": [
{
"type": "FIBER_TOTAL_DIETARY",
"amount": 0,
"name": "Fiber, total dietary",
"unit": "G"
},
{
"type": "CALCIUM_CA",
"amount": 125,
"name": "Calcium, Ca",
"unit": "MG"
},
{
"type": "IRON_FE",
"amount": 0,
"name": "Iron, Fe",
"unit": "MG"
},
{
"type": "VITAMIN_A_IU",
"amount": 125,
"name": "Vitamin A, IU",
"unit": "IU"
},
{
"type": "VITAMIN_C_TOTAL_ASCORBIC_ACID",
"amount": 0,
"name": "Vitamin C, total ascorbic acid",
"unit": "MG"
},
{
"type": "PROTEIN",
"amount": 3.75,
"name": "Protein",
"unit": "G"
},
{
"type": "TOTAL_LIPID_FAT",
"amount": 4.58,
"name": "Total lipid (fat)",
"unit": "G"
},
{
"type": "CARBOHYDRATE_BY_DIFFERENCE",
"amount": 14.17,
"name": "Carbohydrate, by difference",
"unit": "G"
},
{
"type": "ENERGY",
"amount": 112,
"name": "Energy",
"unit": "KCAL"
},
{
"type": "SUGARS_TOTAL_INCLUDING_NLEA",
"amount": 12.92,
"name": "Sugars, total including NLEA",
"unit": "G"
},
{
"type": "POTASSIUM_K",
"amount": 96,
"name": "Potassium, K",
"unit": "MG"
},
{
"type": "SODIUM_NA",
"amount": 67,
"name": "Sodium, Na",
"unit": "MG"
},
{
"type": "CHOLESTEROL",
"amount": 15,
"name": "Cholesterol",
"unit": "MG"
},
{
"type": "FATTY_ACIDS_TOTAL_TRANS",
"amount": 0,
"name": "Fatty acids, total trans",
"unit": "G"
},
{
"type": "FATTY_ACIDS_TOTAL_SATURATED",
"amount": 2.92,
"name": "Fatty acids, total saturated",
"unit": "G"
}
]
}
}
]
}
}
}
Using query variables
To add a barcode as an argument in the search query, define query variables. Refer to this page for more information on how to add them.
query FoodSearch ($query: String, $first: Int, $barcode: String){
brandedFoods(query: $query, first: $first, barcode: $barcode) {
edges {
node {
id
name
gtinUpc
brandOwner
servingSize
servingSizeUnit
nutrients {
id
amount
name
unit
}
}
}
}
}
{
"data": {
"brandedFoods": {
"edges": [
{
"node": {
"id": "QnJhbmRlZEZvb2ROb2RlOjQ3OTk0MQ==",
"name": "Milk",
"gtinUpc": "763528339136",
"brandOwner": "Promised Land Dairy",
"servingSize": 240,
"servingSizeUnit": "ml",
"nutrients": [
{
"id": 1079,
"amount": 0,
"name": "Fiber, total dietary",
"unit": "G"
},
{
"id": 1087,
"amount": 125,
"name": "Calcium, Ca",
"unit": "MG"
},
{
"id": 1089,
"amount": 0,
"name": "Iron, Fe",
"unit": "MG"
},
{
"id": 1104,
"amount": 125,
"name": "Vitamin A, IU",
"unit": "IU"
},
{
"id": 1162,
"amount": 0,
"name": "Vitamin C, total ascorbic acid",
"unit": "MG"
},
{
"id": 1003,
"amount": 3.75,
"name": "Protein",
"unit": "G"
},
{
"id": 1004,
"amount": 4.58,
"name": "Total lipid (fat)",
"unit": "G"
},
{
"id": 1005,
"amount": 14.17,
"name": "Carbohydrate, by difference",
"unit": "G"
},
{
"id": 1008,
"amount": 112,
"name": "Energy",
"unit": "KCAL"
},
{
"id": 2000,
"amount": 12.92,
"name": "Sugars, total including NLEA",
"unit": "G"
},
{
"id": 1092,
"amount": 96,
"name": "Potassium, K",
"unit": "MG"
},
{
"id": 1093,
"amount": 67,
"name": "Sodium, Na",
"unit": "MG"
},
{
"id": 1253,
"amount": 15,
"name": "Cholesterol",
"unit": "MG"
},
{
"id": 1257,
"amount": 0,
"name": "Fatty acids, total trans",
"unit": "G"
},
{
"id": 1258,
"amount": 2.92,
"name": "Fatty acids, total saturated",
"unit": "G"
}
]
}
}
]
}
}
}
{
"query": "milk",
"first": 1,
"barcode": "763528339136"
}
Get the first 2 results of recipes that contain "Oreo" cookies
{
brandedFoods(query: "oreo", first: 2) {
edges {
node {
id
name
gtinUpc
brandOwner
servingSize
servingSizeUnit
nutrients {
id
amount
name
unit
}
}
cursor
}
pageInfo{
hasNextPage
hasPreviousPage
startCursor
endCursor
}
}
}
{
"data": {
"brandedFoods": {
"edges": [
{
"node": {
"id": "QnJhbmRlZEZvb2ROb2RlOjM1MDcyNw==",
"name": "Nabisco oreo cookies oreo 1x10.700 oz",
"gtinUpc": "00044000042554",
"brandOwner": "Mondelez Int. US (0074819091009)",
"servingSize": 29,
"servingSizeUnit": "g",
"nutrients": [
{
"id": 1162,
"amount": 0,
"name": "Vitamin C, total ascorbic acid",
"unit": "MG"
},
{
"id": 1004,
"amount": 20.69,
"name": "Total lipid (fat)",
"unit": "G"
},
{
"id": 1005,
"amount": 72.41,
"name": "Carbohydrate, by difference",
"unit": "G"
},
{
"id": 2000,
"amount": 44.83,
"name": "Sugars, total including NLEA",
"unit": "G"
},
{
"id": 1087,
"amount": 40,
"name": "Calcium, Ca",
"unit": "MG"
},
{
"id": 1089,
"amount": 3.48,
"name": "Iron, Fe",
"unit": "MG"