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:

$$nutrient value *weight/100$$

Where:

• weight is equivalent to the servingSize

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	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	GTIN or UPC number that is included in the food package.
householdServingFulltext	String	Name of the serving
name	String	Name of the food
nutrients	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	Displays the available tags

Pagination

The brandedFoods query supports the use of pagination. The following fields can be used

Query

 pageInfo{
      hasNextPage
      hasPreviousPage
      startCursor
      endCursor
    }

Examples

Get the nutritional information of a specific food

Query

{
  brandedFoods(
    filter: {
      id: "QnJhbmRlZEZvb2ROb2RlOjg4MzE2OTZlLWJiMWItNDhkYi1iMmZjLWRmMzI1YjQ1NDY5OA=="
    }
  ) {
    edges {
      node {
        id
        name
        description
        gtinUpc
        brandOwner
        servingSize
        servingSizeUnit
        nutrients {
          type
          amount
          name
          unit
        }
      }
    }
  }
}

Result

Get the list of recipes that contains "oreo"

The following example searches all the foods that contain oreo in it

Query

{
  brandedFoods(query: "oreo", first: 2) {
    edges {
      node {
        id
        name
        gtinUpc
        brandOwner
        servingSize
        servingSizeUnit
        brandedFoodCategory
        nutrients {
          type
          amount
          name
          unit
        }
      }
    }
  }
}

Response

Get the list of milk recipes with a specific Barcode

• Without using query variables

Query

{
  brandedFoods(barcode: "763528339136") 
  {
    edges {
      node {
        id
        name
        gtinUpc
        brandOwner
        servingSize
        servingSizeUnit
        nutrients {
          type
          amount
          name
          unit
        }
      }
    }
  }
}

Response

• 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

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
        }
      }
    }
  }
}

Response

QUERY VARIABLES

{
  "query": "milk",
  "first": 1,
  "barcode": "763528339136"
}

Get the first 2 results of recipes that contain "Oreo" cookies

Search

{
  brandedFoods(query: "oreo", first: 2) {
    edges {
      node {
        id
        name
        gtinUpc
        brandOwner
        servingSize
        servingSizeUnit
        nutrients {
          id
          amount
          name
          unit
        }
      }
      cursor
    }
       pageInfo{
      hasNextPage
      hasPreviousPage
      startCursor
      endCursor
    }
  }
}

Response

Filter all the common foods that include the "gluten-free" and "low-carb" tags

Query

{
  brandedFoods(first:2     
    filter:
       {
        tags:["gluten-free", "low-carb"] 
       }
   ) 
  {
    edges {
      node {
        id
        name
        gtinUpc
        brandOwner
        servingSize
        servingSizeUnit
        tags
        nutrients {
          type
          amount
          name
          unit
        }
      }
    }
  }
}

Response

Get all the foods that contain banana filtered by specific nutrients

Query

{
   brandedFoods(
    query: "banana"
    first: 3
    filter: {
      nutrients: [
        {nutrient:ENERGY range: {lte: 100}}
        {nutrient:PROTEIN range: {gte: 10}}
      ]
    }
  ) {
    edges {
      node {
        name
        calories
        brandOwner
        servingSize
        servingSizeUnit
      }
    }
  }
}

Response