search_recipes
Search Recipe Reels' catalog of recipes extracted from cooking videos.
Every filter is optional and they combine with AND; an unknown value
simply matches nothing. Without a session token this searches the
public catalog exactly as a logged-out visitor would. Results come
back newest first, each with its nutrition per serving, cost per
serving and `created_at` (when it was imported). Pass a result's `id`
to get_recipe for the full ingredients and steps.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "search_recipes"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| diet | No | A diet tag, e.g. vegetarian, vegan, keto, low-carb, high-protein. | |
| meal | No | breakfast, lunch, dinner or snack. | |
| mine | No | True to search only the connected account's own recipes (My Recipes). Needs session_token. | |
| time | No | Total prep + cook time: 10min, 30min or 1hour (that long or less), or slow_cook (over 1 hour). | |
| limit | No | How many results to return, 1 to 50. | |
| style | No | one_pot, sheet_pan, meal_prep, kid_friendly, party_food or date_night. | |
| budget | No | Under this many US dollars per serving (an estimate from Kroger-family store prices, pantry staples excluded). | |
| course | No | entree, side, dessert, beverage or appetizer. | |
| creator | No | A video creator's name, exactly as `creator_name` shows it on a recipe. | |
| holiday | No | thanksgiving, christmas, new_years, valentines_day, easter, fourth_of_july, halloween, game_day or cinco_de_mayo. | |
| protein | No | At least this many grams of protein per serving. | |
| beverage | No | Drink type: coffee, tea, cocktail, smoothie, juice, milkshake or hot_chocolate. | |
| calories | No | Under this many calories per serving. | |
| platform | No | Where the video came from: Youtube, TikTok, Instagram, Facebook or Pinterest. | |
| video_id | No | A video's own id (`source_video_id`), used with `platform` to find every recipe split from that one video. Needs a session token (any registered account). | |
| dish_type | No | soup, stew_chili, salad, sandwich, wrap_burrito, tacos, burger, pizza, casserole, stir_fry, curry, bowl, dip, sauce_dressing, bread, cookies_bars, cake_cupcakes or pie. | |
| ingredients | No | At most this many ingredients, not counting pantry staples. | |
| nationality | No | Cuisine: indian, western, south_american, korean, chinese, italian, mexican, japanese, mediterranean or thai. | |
| cooking_type | No | stovetop, oven, grill, crockpot, air_fryer, pressure_cooker, smoker, deep_fryer, microwave or no_cook. | |
| session_token | No | Optional: the session token check_agent_connection returned (or send it as an Authorization: Bearer header). Omit it to act as a logged-out visitor. | |
| main_ingredient | No | chicken, ground_beef, beef, pork, sausage, bacon, turkey, salmon, shrimp, fish, tofu, eggs, pasta, rice, potatoes, beans_lentils, cheese, vegetables or fruit. |