Browse a category or a standing list
browse_recipesRead-onlyIdempotent
Read recipe listings from Ptitchef by category or standing lists like latest, top-rated, or most-viewed. Get paginated results without an API key.
Instructions
Read the recipes under one category of Ptitchef, page by page, or one of the lists the site keeps standing. Pass 'category' with a slug from list_categories or from a search's 'topic_slug', or pass 'listing' for one of: latest, top_rated, most_viewed. Never build a category slug by hand: the site writes them freely and answers an address it does not hold by serving another page. The page in the answer is the one the site served, which is the first page again when the page asked for is past the last one.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | The page of a category to read. A standing list has one page only. | |
| limit | No | Rows to render, 20 by default. | |
| listing | No | One of the site's standing lists, read instead of a category. | |
| category | No | A category slug: one from list_categories whose 'is_family' is false, or the 'topic_slug' a search answered with. A family's slug belongs to list_categories instead. |
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. |