Read one recipe, optionally rescaled
get_recipeRead a full recipe by its source ID: ingredients, steps, yield, times, rating, and nutrition. Rescale quantities to any serving count and return only the sections you select.
Instructions
Read one recipe in full: its ingredients, its steps, what it yields, and whatever times, rating and nutrition its source publishes. 'id' must come from search_recipes. It names the source, so this reads the right one without guessing; an identifier no source would have minted is refused, because sending it anywhere would answer about the wrong dish. Pass 'servings' to rescale. Quantities land where a kitchen can follow them: an egg stays whole, anything that pours or cuts can halve, a small measurement moves to a smaller unit before it is rounded, and anything unmultipliable is flagged rather than scaled. A page that states no number of servings comes back as published and says so, because dividing by a yield nobody wrote would answer for a number of people the page never claimed. A part this answer holds nothing for says which of two things happened: the page showed no sign of it, or this server failed to read what the page carries. An empty ingredient list is never evidence that an ingredient is absent from the dish. 'sections' decides what comes back, and 'sections_omitted' names what was left out: a field belonging to an omitted section is empty because nobody asked for it, never because the page states nothing. A field a source does not publish is null, never zero. Credit the source and link the url when you repeat any of it.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | From search_recipes, such as 'marmiton:44078', 'goodfood:recipes/carbonara' or 'cookbook:Cookbook:Carbonara'. Two sources address a recipe by a bare number, so spell an id with its source. | |
| sections | No | Which parts to return. A full recipe is a lot of text, so this defaults to two. | |
| servings | No | Rescale to this many. Left out, the quantities come back as published. | |
| max_steps | No | Steps to return. The answer says how many more there are. | |
| max_step_chars | No | Characters kept per step. Raise it only if a step was cut mid-sentence. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| notes | Yes | ||
| recipe | Yes | ||
| id_read_as | Yes | How a raw identifier was routed, when it was not spelled with its source. |