products

Search Grocery Products

Changed on

Search packaged food products, such as frozen pizza or Greek yogurt.

get/food/products/search

Request

  • Base URL
    https://api.spoonacular.com
  • Auth
    API key in header x-api-key

Query parameters

querystring
Example:burger

The (natural language) search query.

minCaloriesnumber
Example:50

The minimum amount of calories the product must have.

maxCaloriesnumber
Example:800

The maximum amount of calories the product can have.

minCarbsnumber
Example:10

The minimum amount of carbohydrates in grams the product must have.

maxCarbsnumber
Example:100

The maximum amount of carbohydrates in grams the product can have.

minProteinnumber
Example:10

The minimum amount of protein in grams the product must have.

maxProteinnumber
Example:100

The maximum amount of protein in grams the product can have.

minFatnumber
Example:1

The minimum amount of fat in grams the product must have.

maxFatnumber
Example:100

The maximum amount of fat in grams the product can have.

addProductInformationfalse | true
Example:true

If set to true, you get more information about the products returned.

offsetinteger

The number of results to skip (between 0 and 900).

numberinteger
Example:10

The maximum number of items to return (between 1 and 100). Defaults to 10.

Response

Success

totalProductsinteger required
typestring required
offsetinteger required
numberinteger required

Changes

    • breaking

      for the query request parameter number, default value 10 was added

    • breaking

      for the query request parameter number, the type changed from number to integer

    • breaking

      for the query request parameter offset, the type changed from number to integer

    12 more changes in this revision