Ingredient Search

GET {{baseUrl}}/food/ingredients/search?query=burger&addChildren=true&minProteinPercent=10&maxProteinPercent=90&minFatPercent=10&maxFatPercent=90&minCarbsPercent=10&maxCarbsPercent=90&metaInformation=false&intolerances=egg&sort=calories&sortDirection=asc&offset=394&number=10

Search for simple whole foods (e.g. fruits, vegetables, nuts, grains, meat, fish, dairy etc.).

Request Params

KeyDatatypeRequiredDescription
querystringThe (natural language) search query.
addChildrenbooleanWhether to add children of found foods.
minProteinPercentnumberThe minimum percentage of protein the food must have (between 0 and 100).
maxProteinPercentnumberThe maximum percentage of protein the food can have (between 0 and 100).
minFatPercentnumberThe minimum percentage of fat the food must have (between 0 and 100).
maxFatPercentnumberThe maximum percentage of fat the food can have (between 0 and 100).
minCarbsPercentnumberThe minimum percentage of carbs the food must have (between 0 and 100).
maxCarbsPercentnumberThe maximum percentage of carbs the food can have (between 0 and 100).
metaInformationbooleanWhether to return more meta information about the ingredients.
intolerancesstringA comma-separated list of intolerances. All recipes returned must not contain ingredients that are not suitable for people with the intolerances entered. See a full list of supported intolerances.
sortstringThe strategy to sort recipes by. See a full list of supported sorting options.
sortDirectionstringThe direction in which to sort. Must be either 'asc' (ascending) or 'desc' (descending).
offsetnumberThe number of results to skip (between 0 and 900).
numbernumberThe maximum number of items to return (between 1 and 100). Defaults to 10.

RESPONSES

status: OK

{"results":[{"id":19400,"name":"banana chips","image":"banana-chips.jpg"},{"id":93779,"name":"banana liqueur","image":"limoncello.jpg"}],"offset":0,"number":2,"totalResults":13}