La documentazione per sviluppatori è in inglese.
Tipo di scheda
recipe.search
Recipes for a dish or for constraints (diet, nutrients, time, cuisine, meal type, ingredients), with their photos, macros and filters that say how many recipes each option leaves. Creative Commons recipes only, so every photo may be shown with its credit.
Version 1 · schema recipe.search.v1.schema.json
Layouts
Every card type has full. Pick a layout with the element's layout attribute, render.layout, or a theme.
Fields
The fields of card.data. Values a source doesn't provide are null; new optional fields can appear within version 1.
| Field | Type | Required | Notes |
|---|---|---|---|
query | string | yes | The dish or ingredients searched for, in English, without the words the filters took ("chicken pasta with mushrooms"). Empty when only filters were asked for. |
filters | object | yes | Diets all apply (and), cuisines and meal types any (or); every other filter applies too. |
filters.diets[] | enum[] | yes | |
filters.avoid[] | enum[] | yes | |
filters.cuisines[] | enum[] | yes | |
filters.meal_types[] | enum[] | yes | |
filters.max_time_min | enum | yes | Ready in at most this many minutes. Recipes without a known time are left out while it is set. · 15 · 30 · 45 · 60 |
filters.include[] | string[] | yes | Ingredients every recipe must have, in English. |
filters.exclude[] | string[] | yes | Ingredients no recipe may have, in English. |
filters.nutrients | object | yes | Per-serving bounds by nutrient; a nutrient without bounds is left out. |
filters.nutrients.calories | object | ||
filters.nutrients.protein | object | ||
filters.nutrients.carbs | object | ||
filters.nutrients.fat | object | ||
filters.nutrients.fiber | object | ||
filters.nutrients.sugar | object | ||
filters.nutrients.sodium | object | ||
filters.nutrients.cholesterol | object | ||
filters.nutrients.saturated_fat | object | ||
filters.nutrients.trans_fat | object | ||
filters.nutrients.mono_unsaturated_fat | object | ||
filters.nutrients.poly_unsaturated_fat | object | ||
filters.nutrients.calcium | object | ||
filters.nutrients.iron | object | ||
filters.nutrients.magnesium | object | ||
filters.nutrients.potassium | object | ||
filters.nutrients.zinc | object | ||
filters.nutrients.copper | object | ||
filters.nutrients.manganese | object | ||
filters.nutrients.phosphorus | object | ||
filters.nutrients.selenium | object | ||
filters.nutrients.iodine | object | ||
filters.nutrients.fluoride | object | ||
filters.nutrients.choline | object | ||
filters.nutrients.vitamin_a | object | ||
filters.nutrients.vitamin_c | object | ||
filters.nutrients.vitamin_d | object | ||
filters.nutrients.vitamin_e | object | ||
filters.nutrients.vitamin_k | object | ||
filters.nutrients.vitamin_b1 | object | ||
filters.nutrients.vitamin_b2 | object | ||
filters.nutrients.vitamin_b3 | object | ||
filters.nutrients.vitamin_b5 | object | ||
filters.nutrients.vitamin_b6 | object | ||
filters.nutrients.vitamin_b12 | object | ||
filters.nutrients.folate | object | ||
filters.nutrients.folic_acid | object | ||
filters.nutrients.caffeine | object | ||
sort | enum | yes | match: best match first; protein: most protein; calories: fewest calories; time: quickest, recipes without a time last; popular: most liked; health: highest health score. match · protein · calories · time · popular · health |
total | integer | yes | How many recipes match, of which results holds the first limit. |
limit | integer | yes | How many results were asked for: 24, or more after a refine asked for more. |
results[] | object[] | yes | |
results[].id | integer | yes | The recipe's id: a refine {card: "recipe", id} answers with its recipe card. |
results[].title | string | yes | |
results[].image | image | null | yes | |
results[].image.url | url | yes | WebKnox media URL: https://webknox.com/media/v1/<host>/<path>. Treat it as opaque. |
results[].image.width | integer | null | ||
results[].image.height | integer | null | ||
results[].image.credit | string | yes | |
results[].image.license | string | yes | |
results[].image.source_url | url | yes | |
results[].time_min | integer | null | yes | Ready in, or null when the recipe gives no real time. |
results[].servings | integer | null | yes | |
results[].diets[] | enum[] | yes | |
results[].cuisines[] | enum[] | yes | |
results[].meal_types[] | enum[] | yes | |
results[].nutrition | object | yes | Per serving: calories, protein, carbs and fat always; any other nutrient filtered or sorted on. Units as in $defs/nutrient. null when the recipe gives no nutrition: such a recipe passes no nutrient filter and sorts last. |
results[].nutrition.calories | number | null | yes | |
results[].nutrition.protein | number | null | yes | |
results[].nutrition.carbs | number | null | yes | |
results[].nutrition.fat | number | null | yes | |
results[].nutrition.fiber | number | null | ||
results[].nutrition.sugar | number | null | ||
results[].nutrition.sodium | number | null | ||
results[].nutrition.cholesterol | number | null | ||
results[].nutrition.saturated_fat | number | null | ||
results[].nutrition.trans_fat | number | null | ||
results[].nutrition.mono_unsaturated_fat | number | null | ||
results[].nutrition.poly_unsaturated_fat | number | null | ||
results[].nutrition.calcium | number | null | ||
results[].nutrition.iron | number | null | ||
results[].nutrition.magnesium | number | null | ||
results[].nutrition.potassium | number | null | ||
results[].nutrition.zinc | number | null | ||
results[].nutrition.copper | number | null | ||
results[].nutrition.manganese | number | null | ||
results[].nutrition.phosphorus | number | null | ||
results[].nutrition.selenium | number | null | ||
results[].nutrition.iodine | number | null | ||
results[].nutrition.fluoride | number | null | ||
results[].nutrition.choline | number | null | ||
results[].nutrition.vitamin_a | number | null | ||
results[].nutrition.vitamin_c | number | null | ||
results[].nutrition.vitamin_d | number | null | ||
results[].nutrition.vitamin_e | number | null | ||
results[].nutrition.vitamin_k | number | null | ||
results[].nutrition.vitamin_b1 | number | null | ||
results[].nutrition.vitamin_b2 | number | null | ||
results[].nutrition.vitamin_b3 | number | null | ||
results[].nutrition.vitamin_b5 | number | null | ||
results[].nutrition.vitamin_b6 | number | null | ||
results[].nutrition.vitamin_b12 | number | null | ||
results[].nutrition.folate | number | null | ||
results[].nutrition.folic_acid | number | null | ||
results[].nutrition.caffeine | number | null | ||
results[].likes | integer | yes | |
results[].health_score | integer | null | yes | |
results[].source_name | string | null | yes | |
results[].source_url | url | null | yes | |
facets | object | yes | For every option the filters offer: how many recipes there would be with that option added to the applied filters (for an applied option: total). Options that leave none can be shown as unavailable. |
facets.diets | object | yes | By diet. |
facets.diets.vegetarian | integer | ||
facets.diets.vegan | integer | ||
facets.diets.pescetarian | integer | ||
facets.diets.gluten free | integer | ||
facets.diets.dairy free | integer | ||
facets.diets.ketogenic | integer | ||
facets.diets.paleo | integer | ||
facets.diets.whole30 | integer | ||
facets.avoid | object | yes | By allergen: recipes without it. |
facets.avoid.dairy | integer | ||
facets.avoid.gluten | integer | ||
facets.avoid.tree nuts | integer | ||
facets.avoid.peanuts | integer | ||
facets.avoid.fish | integer | ||
facets.avoid.shellfish | integer | ||
facets.avoid.sesame | integer | ||
facets.avoid.soy | integer | ||
facets.cuisines | object | yes | By cuisine. |
facets.cuisines.african | integer | ||
facets.cuisines.american | integer | ||
facets.cuisines.asian | integer | ||
facets.cuisines.british | integer | ||
facets.cuisines.cajun | integer | ||
facets.cuisines.caribbean | integer | ||
facets.cuisines.chinese | integer | ||
facets.cuisines.eastern european | integer | ||
facets.cuisines.european | integer | ||
facets.cuisines.french | integer | ||
facets.cuisines.german | integer | ||
facets.cuisines.greek | integer | ||
facets.cuisines.indian | integer | ||
facets.cuisines.irish | integer | ||
facets.cuisines.italian | integer | ||
facets.cuisines.japanese | integer | ||
facets.cuisines.jewish | integer | ||
facets.cuisines.korean | integer | ||
facets.cuisines.latin american | integer | ||
facets.cuisines.mediterranean | integer | ||
facets.cuisines.mexican | integer | ||
facets.cuisines.middle eastern | integer | ||
facets.cuisines.nordic | integer | ||
facets.cuisines.southern | integer | ||
facets.cuisines.spanish | integer | ||
facets.cuisines.thai | integer | ||
facets.cuisines.vietnamese | integer | ||
facets.meal_types | object | yes | By meal type. |
facets.meal_types.main course | integer | ||
facets.meal_types.side dish | integer | ||
facets.meal_types.appetizer | integer | ||
facets.meal_types.salad | integer | ||
facets.meal_types.soup | integer | ||
facets.meal_types.breakfast | integer | ||
facets.meal_types.dessert | integer | ||
facets.meal_types.snack | integer | ||
facets.time | object | yes | With every filter but the time limit: how many are ready in at most 15, 30, 45 and 60 minutes, how many give no real time, and of how many. |
facets.time.15 | integer | yes | |
facets.time.30 | integer | yes | |
facets.time.45 | integer | yes | |
facets.time.60 | integer | yes | |
facets.time.unknown | integer | yes | |
facets.time.of | integer | yes | |
facets.nutrients | object | yes | Calories, protein, carbs and fat with every filter but that nutrient's: counts in 14 equal bins from 0 to max (the last bin also holds everything above). |
facets.nutrients.calories | object | yes | |
facets.nutrients.protein | object | yes | |
facets.nutrients.carbs | object | yes | |
facets.nutrients.fat | object | yes | |
relax[] | object[] | yes | Only when nothing matches: applied filters that, dropped alone, bring recipes back, with how many. Empty otherwise. |
relax[].filter | object | yes | One applied filter: a diet, allergen, cuisine, meal type or ingredient value, a nutrient's key, or the time limit (value null). |
relax[].filter.kind | enum | yes | diet · avoid · cuisine · meal_type · time · include · exclude · nutrient |
relax[].filter.value | string | null | yes | |
relax[].count | integer | yes |
Example
A recorded answer to “Chicken pasta recipes”. Open it in the Answer Lab to see every layout and style.
{
"v": 2,
"id": "ans_s69dtnvy3w1zzuut",
"matched": true,
"locale": "en",
"skill": "recipe_search",
"confidence": 0.9,
"text": "12 recipes for chicken pasta. The best matches: Pasta With Chicken and Mushrooms (463 kcal); Penne Pasta With Chicken And Mushrooms (834 kcal); Chicken Ragu w Rigatoni (605 kcal); Chicken Teriyaki with Soba Noodles (696 kcal); Chicken Pasta Primavera - Flower Patch Farmgirl Style (427 kcal).",
"speech": "I found 12 recipes for chicken pasta. The top one is Pasta With Chicken and Mushrooms, 463 calories per serving.",
"card": {
"type": "recipe.search",
"version": 1,
"data": {
"query": "chicken pasta",
"filters": {
"diets": [],
"avoid": [],
"cuisines": [],
"meal_types": [],
"max_time_min": null,
"include": [],
"exclude": [],
"nutrients": {}
},
"sort": "match",
"total": 12,
"limit": 24,
"results": [
{
"id": 654913,
"title": "Pasta With Chicken and Mushrooms",
"image": {
"url": "https://webknox.com/media/v1/img.spoonacular.com/recipes/654913-556x370.jpg",
"width": 556,
"height": 370,
"credit": "Foodista.com – The Cooking Encyclopedia Everyone Can Edit",
"license": "CC BY 3.0",
"source_url": "https://www.foodista.com/recipe/6QZ47BPL/pasta-with-chicken-and-mushrooms"
},
"time_min": null,
"servings": 6,
"diets": [
"dairy free"
],
"cuisines": [],
"meal_types": [
"main course",
"side dish"
],
"nutrition": {
"calories": 463,
"protein": 36,
"carbs": 64,
"fat": 5.8
},
"likes": 2,
"health_score": 22,
"source_name": "Foodista",
"source_url": "https://www.foodista.com/recipe/6QZ47BPL/pasta-with-chicken-and-mushrooms"
},
{
"id": 655582,
"title": "Penne Pasta With Chicken And Mushrooms",
"image": {
"url": "https://webknox.com/media/v1/img.spoonacular.com/recipes/655582-556x370.jpg",
"width": 556,
"height": 370,
"credit": "Foodista.com – The Cooking Encyclopedia Everyone Can Edit",
"license": "CC BY 3.0",
"source_url": "https://www.foodista.com/recipe/52PT5D6Y/penne-pasta-with-chicken-and-mushrooms"
},
"time_min": null,
"servings": 2,
"diets": [],
"cuisines": [],
"meal_types": [
"main course",
"side dish"
],
"nutrition": {
"calories": 834,
"protein": 41,
"carbs": 48,
"fat": 53
},
"likes": 1,
"health_score": 18,
"source_name": "Foodista",
"source_url": "https://www.foodista.com/recipe/52PT5D6Y/penne-pasta-with-chicken-and-mushrooms"
},
{
"id": 638272,
"title": "Chicken Ragu w Rigatoni",
"image": {
"url": "https://webknox.com/media/v1/img.spoonacular.com/recipes/638272-556x370.jpg",
"width": 556,
"height": 370,
"credit": "Foodista.com – The Cooking Encyclopedia Everyone Can Edit",
"license": "CC BY 3.0",
"source_url": "https://www.foodista.com/recipe/MPLPCFCS/chicken-ragu-w-rigatoni"
},
"time_min": null,
"servings": 6,
"diets": [],
"cuisines": [],
"meal_types": [
"main course",
"side dish"
],
"nutrition": {
"calories": 605,
"protein": 40,
"carbs": 74,
"fat": 14
},
"likes": 1,
"health_score": 36,
"source_name": "Foodista",
"source_url": "https://www.foodista.com/recipe/MPLPCFCS/chicken-ragu-w-rigatoni"
},
{
"id": 638382,
"title": "Chicken Teriyaki with Soba Noodles",
"image": {
"url": "https://webknox.com/media/v1/img.spoonacular.com/recipes/638382-556x370.jpg",
"width": 556,
"height": 370,
"credit": "Foodista.com – The Cooking Encyclopedia Everyone Can Edit",
"license": "CC BY 3.0",
"source_url": "https://www.foodista.com/recipe/2KWF3F3B/chicken-teriyaki-with-soba-noodles"
},
"time_min": null,
"servings": 2,
"diets": [
"dairy free"
],
"cuisines": [
"asian",
"japanese"
],
"meal_types": [
"main course"
],
"nutrition": {
"calories": 696,
"protein": 46,
"carbs": 101,
"fat": 16
},
"likes": 1,
"health_score": 36,
"source_name": "Foodista",
"source_url": "https://www.foodista.com/recipe/2KWF3F3B/chicken-teriyaki-with-soba-noodles"
},
{
"id": 638236,
"title": "Chicken Pasta Primavera - Flower Patch Farmgirl Style",
"image": {
"url": "https://webknox.com/media/v1/img.spoonacular.com/recipes/638236-556x370.jpg",
"width": 556,
"height": 370,
"credit": "Foodista.com – The Cooking Encyclopedia Everyone Can Edit",
"license": "CC BY 3.0",
"source_url": "https://www.foodista.com/recipe/NDRHPYQP/chicken-pasta-primavera-flower-patch-farmgirl-style"
},
"time_min": null,
"servings": 8,
"diets": [],
"cuisines": [
"european",
"italian",
"mediterranean"
],
"meal_types": [
"main course"
],
"nutrition": {
"calories": 427,
"protein": 29,
"carbs": 44,
"fat": 16
},
"likes": 1,
"health_score": 39,
"source_name": "Foodista",
"source_url": "https://www.foodista.com/recipe/NDRHPYQP/chicken-pasta-primavera-flower-patch-farmgirl-style"
},
{
"id": 637923,
"title": "Chicken and Penne Pasta With Garlic Rosemary Sauce",
"image": {
"url": "https://webknox.com/media/v1/img.spoonacular.com/recipes/637923-556x370.jpg",
"width": 556,
"height": 370,
"credit": "Foodista.com – The Cooking Encyclopedia Everyone Can Edit",
"license": "CC BY 3.0",
"source_url": "https://www.foodista.com/recipe/DTDN76GH/chicken-and-penne-pasta-with-garlic-rosemary-sauce"
},
"time_min": null,
"servings": 4,
"diets": [
"dairy free"
],
"cuisines": [],
"meal_types": [
"main course",
"side dish"
],
"nutrition": {
"calories": 884,
"protein": 88,
"carbs": 88,
"fat": 18
},
"likes": 1,
"health_score": 52,
"source_name": "Foodista",
"source_url": "https://www.foodista.com/recipe/DTDN76GH/chicken-and-penne-pasta-with-garlic-rosemary-sauce"
},
{
"id": 638248,
"title": "Chicken Piccata With Angel Hair Pasta",
"image": {
"url": "https://webknox.com/media/v1/img.spoonacular.com/recipes/638248-556x370.jpg",
"width": 556,
"height": 370,
"credit": "Foodista.com – The Cooking Encyclopedia Everyone Can Edit",
"license": "CC BY 3.0",
"source_url": "https://www.foodista.com/recipe/7F7DBP8R/chicken-piccata-with-angel-hair-pasta"
},
"time_min": null,
"servings": 2,
"diets": [],
"cuisines": [],
"meal_types": [
"main course"
],
"nutrition": {
"calories": 816,
"protein": 40,
"carbs": 95,
"fat": 32
},
"likes": 60,
"health_score": 34,
"source_name": "Foodista",
"source_url": "https://www.foodista.com/recipe/7F7DBP8R/chicken-piccata-with-angel-hair-pasta"
},
{
"id": 1096054,
"title": "Spicy Chicken Pasta and Peas with Sun-Dried Tomato Sauce",
"image": {
"url": "https://webknox.com/media/v1/img.spoonacular.com/recipes/1096054-556x370.jpg",
"width": 556,
"height": 370,
"credit": "Foodista.com – The Cooking Encyclopedia Everyone Can Edit",
"license": "CC BY 3.0",
"source_url": "https://www.foodista.com/recipe/JBY64G5J/spicy-chicken-pasta-and-peas-with-sun-dried-tomato-sauce"
},
"time_min": 30,
"servings": 6,
"diets": [],
"cuisines": [],
"meal_types": [
"main course",
"side dish"
],
"nutrition": {
"calories": 608,
"protein": 34,
"carbs": 50,
"fat": 31
},
"likes": 1,
"health_score": 24,
"source_name": "Foodista",
"source_url": "https://www.foodista.com/recipe/JBY64G5J/spicy-chicken-pasta-and-peas-with-sun-dried-tomato-sauce"
},
{
"id": 654901,
"title": "Pasta With Chicken and Broccoli",
"image": {
"url": "https://webknox.com/media/v1/img.spoonacular.com/recipes/654901-556x370.jpg",
"width": 556,
"height": 370,
"credit": "Foodista.com – The Cooking Encyclopedia Everyone Can Edit",
"license": "CC BY 3.0",
"source_url": "https://www.foodista.com/recipe/Y5X6DRHT/pasta-with-chicken-and-broccoli"
},
"time_min": null,
"servings": 4,
"diets": [],
"cuisines": [],
"meal_types": [
"main course",
"side dish"
],
"nutrition": {
"calories": 429,
"protein": 26,
"carbs": 25,
"fat": 24
},
"likes": 3,
"health_score": 16,
"source_name": "Foodista",
"source_url": "https://www.foodista.com/recipe/Y5X6DRHT/pasta-with-chicken-and-broccoli"
},
{
"id": 638245,
"title": "Chicken Pasta With Anchovy Rosemary Sauce",
"image": {
"url": "https://webknox.com/media/v1/img.spoonacular.com/recipes/638245-556x370.jpg",
"width": 556,
"height": 370,
"credit": "Foodista.com – The Cooking Encyclopedia Everyone Can Edit",
"license": "CC BY 3.0",
"source_url": "https://www.foodista.com/recipe/QVWP6WF5/chicken-pasta-with-anchovy-rosemary-sauce"
},
"time_min": null,
"servings": 4,
"diets": [
"dairy free"
],
"cuisines": [],
"meal_types": [
"main course",
"side dish"
],
"nutrition": {
"calories": 394,
"protein": 23,
"carbs": 44,
"fat": 14
},
"likes": 2,
"health_score": 16,
"source_name": "Foodista",
"source_url": "https://www.foodista.com/recipe/QVWP6WF5/chicken-pasta-with-anchovy-rosemary-sauce"
},
{
"id": 645651,
"title": "Grilled Chicken Pasta With Gorgonzola Walnut Cream Sauce",
"image": {
"url": "https://webknox.com/media/v1/img.spoonacular.com/recipes/645651-556x370.jpg",
"width": 556,
"height": 370,
"credit": "Foodista.com – The Cooking Encyclopedia Everyone Can Edit",
"license": "CC BY 3.0",
"source_url": "https://www.foodista.com/recipe/3XL3LWV3/grilled-chicken-pasta-with-gorgonzola-walnut-cream-sauce"
},
"time_min": null,
"servings": 6,
"diets": [],
"cuisines": [],
"meal_types": [
"main course",
"side dish"
],
"nutrition": {
"calories": 855,
"protein": 56,
"carbs": 62,
"fat": 40
},
"likes": 1,
"health_score": 29,
"source_name": "Foodista",
"source_url": "https://www.foodista.com/recipe/3XL3LWV3/grilled-chicken-pasta-with-gorgonzola-walnut-cream-sauce"
},
{
"id": 638338,
"title": "Chicken Spaghettini With Fried Capers",
"image": {
"url": "https://webknox.com/media/v1/img.spoonacular.com/recipes/638338-556x370.jpg",
"width": 556,
"height": 370,
"credit": "Foodista.com – The Cooking Encyclopedia Everyone Can Edit",
"license": "CC BY 3.0",
"source_url": "https://www.foodista.com/recipe/TXZ2TYXV/chicken-spaghettini-with-fried-capers"
},
"time_min": null,
"servings": 2,
"diets": [],
"cuisines": [],
"meal_types": [
"main course",
"side dish"
],
"nutrition": {
"calories": 1105,
"protein": 39,
"carbs": 99,
"fat": 62
},
"likes": 44,
"health_score": 22,
"source_name": "Foodista",
"source_url": "https://www.foodista.com/recipe/TXZ2TYXV/chicken-spaghettini-with-fried-capers"
}
],
"facets": {
"diets": {
"vegetarian": 0,
"vegan": 0,
"pescetarian": 0,
"gluten free": 0,
"dairy free": 4,
"ketogenic": 0,
"paleo": 0,
"whole30": 0
},
"avoid": {
"dairy": 4,
"gluten": 0,
"tree nuts": 10,
"peanuts": 12,
"fish": 11,
"shellfish": 12,
"sesame": 11,
"soy": 11
},
"cuisines": {
"african": 0,
"american": 0,
"asian": 1,
"british": 0,
"cajun": 0,
"caribbean": 0,
"chinese": 0,
"eastern european": 0,
"european": 1,
"french": 0,
"german": 0,
"greek": 0,
"indian": 0,
"irish": 0,
"italian": 1,
"japanese": 1,
"jewish": 0,
"korean": 0,
"latin american": 0,
"mediterranean": 1,
"mexican": 0,
"middle eastern": 0,
"nordic": 0,
"southern": 0,
"spanish": 0,
"thai": 0,
"vietnamese": 0
},
"meal_types": {
"main course": 12,
"side dish": 9,
"appetizer": 0,
"salad": 0,
"soup": 0,
"breakfast": 0,
"dessert": 0,
"snack": 0
},
"time": {
"15": 0,
"30": 1,
"45": 1,
"60": 1,
"unknown": 11,
"of": 12
},
"nutrients": {
"calories": {
"max": 1200,
"bins": [
0,
0,
0,
0,
2,
2,
0,
2,
1,
3,
1,
0,
1,
0
]
},
"protein": {
"max": 100,
"bins": [
0,
0,
0,
2,
2,
5,
1,
1,
0,
0,
0,
0,
1,
0
]
},
"carbs": {
"max": 120,
"bins": [
0,
0,
1,
0,
0,
4,
0,
2,
1,
0,
1,
3,
0,
0
]
},
"fat": {
"max": 80,
"bins": [
0,
1,
4,
1,
1,
2,
0,
1,
0,
1,
1,
0,
0,
0
]
}
}
},
"relax": []
}
},
"sources": [
{
"name": "Foodista",
"url": "https://www.foodista.com",
"license": "CC BY 3.0"
}
],
"follow_ups": [],
"actions": [],
"usage": {
"billable": true
}
}