`recipe`

Ingredients and steps; steps may carry timers.

Version 1 · schema recipe.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
`title`	`string`	yes
`image`	`image \| null`	yes
`image.url`	`url`	yes	WebKnox media URL: https://webknox.com/media/v1/<host>/<path>. Treat it as opaque.
`image.width`	`integer \| null`
`image.height`	`integer \| null`
`image.credit`	`string`	yes
`image.license`	`string`	yes
`image.source_url`	`url`	yes
`time_min`	`integer`	yes
`servings`	`integer`	yes
`servings_unit`	`string`	yes	What one serving is, e.g. pancakes, portions.
`difficulty`	`enum`	yes	easy · medium · hard
`ingredients[]`	`object[]`	yes
`ingredients[].amount`	`number \| null`	yes
`ingredients[].unit`	`string \| null`	yes
`ingredients[].name`	`string`	yes
`steps[]`	`object[]`	yes
`steps[].text`	`string`	yes
`steps[].timer_s`	`integer \| null`		Lets the client offer a timer for this step.

Example

A recorded answer to “How do I make pancakes?”. Open it in the Answer Lab to see every layout and style.

Response

1{
2  "v": 2,
3  "id": "ans_xccv7otxeqwf0bvw",
4  "matched": true,
5  "locale": "en",
6  "skill": "recipes",
7  "confidence": 0.9,
8  "text": "Here's Cocoa Protein Pancakes: ready in 15 minutes, for 2 servings. You need: 1 tablespoon cocoa powder; 1 cup quark or cottage cheese; 3 eggs; maple syrup; 1 cup rolled oats. 1. Blend the rolled oats in a blender or food processor until you have a fine powder. 2. Mix in the cocoa powder. 3. Blend the ground oats/cocoa powder with the cottage cheese (or quark, if you can find it) and eggs. 4. Pour the thick batter into a hot, oiled skillet and use the back of a spoon to form round pancakes. 5. Flip the pancakes once the sides are firm and turning brown.. 6. Serve with maple syrup. https://spoonacular.com/cocoa-protein-pancakes-157259",
9  "speech": "Here's Cocoa Protein Pancakes: ready in 15 minutes, for 2 servings.",
10  "card": {
11    "type": "recipe",
12    "version": 1,
13    "data": {
14      "title": "Cocoa Protein Pancakes",
15      "image": null,
16      "time_min": 15,
17      "servings": 2,
18      "servings_unit": "servings",
19      "difficulty": "easy",
20      "ingredients": [
21        {
22          "amount": 1,
23          "unit": "tablespoon",
24          "name": "cocoa powder"
25        },
26        {
27          "amount": 1,
28          "unit": "cup",
29          "name": "quark or cottage cheese"
30        },
31        {
32          "amount": 3,
33          "unit": null,
34          "name": "eggs"
35        },
36        {
37          "amount": null,
38          "unit": null,
39          "name": "maple syrup"
40        },
41        {
42          "amount": 1,
43          "unit": "cup",
44          "name": "rolled oats"
45        }
46      ],
47      "steps": [
48        {
49          "text": "Blend the rolled oats in a blender or food processor until you have a fine powder."
50        },
51        {
52          "text": "Mix in the cocoa powder."
53        },
54        {
55          "text": "Blend the ground oats/cocoa powder with the cottage cheese (or quark, if you can find it) and eggs."
56        },
57        {
58          "text": "Pour the thick batter into a hot, oiled skillet and use the back of a spoon to form round pancakes."
59        },
60        {
61          "text": "Flip the pancakes once the sides are firm and turning brown.."
62        },
63        {
64          "text": "Serve with maple syrup."
65        }
66      ]
67    }
68  },
69  "sources": [
70    {
71      "name": "spoonacular.com",
72      "url": "https://spoonacular.com/cocoa-protein-pancakes-157259",
73      "license": null
74    }
75  ],
76  "follow_ups": [],
77  "actions": [],
78  "usage": {
79    "billable": true
80  }
81}