Find recipes from the ingredients a cook has
search_by_ingredientsRead-onlyIdempotent
Find Ptitchef recipes from ingredients you already have. Enter one to five ingredients in French to see matching recipes.
Instructions
Find Ptitchef recipes from the ingredients a cook already has. Give one to 5 ingredients in French, as a cook would name them ("poulet", "citron"). The site counts every recipe it finds and serves one page of them, so 'total_available' can be far larger than the rows returned, and the rest cannot be reached. A longer list than the site's own form reads is refused rather than sent and silently cut.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Rows to render, 20 by default. | |
| ingredients | Yes | One to 5 ingredients, in French. The site reads no more than that. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | The address the listing was read from. | |
| kind | Yes | How the listing came to be, which decides what its total counts. 'topic' means the site answered a search from a page of its own; 'free_text' means it answered on its own terms. | |
| page | Yes | The page that was read, which is the one the site served. | |
| asked | Yes | What was asked for: a search, a category, or a list of ingredients. 'query' carries the same value under the name every source of recipes publishes it in. | |
| notes | Yes | What qualifies this answer: what its total counts, what it left out, and where the site answered from an address other than the one asked for. Read these before quoting a figure. | |
| query | Yes | What was asked for, under the name a search publishes it in. | |
| title | Yes | The site's own heading for the listing. | |
| folded | Yes | Rows naming a recipe already held. A guide lists one recipe under two headings where it belongs to both; such a row is counted in 'rows_seen' and rendered once. | |
| source | Yes | The site this answer was read from. Credit it when showing a row. | |
| results | Yes | ||
| rows_seen | Yes | Rows the site served on this page, before any were set aside. | |
| topic_slug | Yes | The category page this listing was served from. Pass it to browse_recipes as 'category' to read the topic's further pages, and its total where this answer carries none. | |
| single_page | Yes | True when the site serves this listing on one page and offers no further one. | |
| result_count | Yes | Rows rendered here. | |
| total_available | Yes | Recipes the site says this listing holds. Null when it published no figure. |