Search the recipes
search_recipesRead-onlyIdempotent
Find French recipes on Supertoinette by dish or ingredient. Use the returned category facets to narrow results, and each row's identifier to open the full recipe.
Instructions
Search Supertoinette by a dish or an ingredient. Each row carries the identifier to read the recipe with get_recipe. The site publishes no total, so 'total_available' is null and 'last_page' says how far the results run. The categories it counts beside a search are returned as 'facets': pass one back as 'category' to narrow the search, spelled exactly as the site spells it. A category the site does not know is answered like a search that matched nothing, so a filter that finds nothing is dropped and the answer says so.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Which page of results to read, 1 by default. 'last_page' says how far they run. | |
| limit | No | Rows to render, 20 by default. The site serves at most 39 to a page, and 'rows_published' always states what the page held. | |
| query | Yes | A dish or an ingredient to look for, in French. | |
| category | No | Narrow the search to one category, taken from the 'facets' of a previous answer and spelled exactly as the site spells it. Never build one by hand: the site answers a wording it does not know with a page that reads as an absence. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | The page these rows were read from. | |
| page | Yes | The page these rows were read from. | |
| notes | Yes | ||
| query | Yes | ||
| facets | Yes | The categories the site counts inside this search. A recipe filed under two is counted by both, so these do not add up to the rows served. | |
| source | Yes | ||
| results | Yes | ||
| category | Yes | The category the answer was narrowed to, or null for a search across all of them. | |
| last_page | Yes | The highest page the site links to from this one. | |
| result_count | Yes | Rows rendered here. | |
| rows_published | Yes | Rows the page held, before any were rendered. | |
| total_available | Yes | Supertoinette prints no total on a search page, so there is none to report. |