| who | No | who is eating, by the names or roles saved as people on the profile, e.g. ['Dad','Ana'] or ['adults'] when the kids are out, ['kids'] when only they eat; only those people's allergens and dislikes apply on top of the household's; leave empty for everyone | |
| site | No | restrict to one source site slug, e.g. budgetbytes | |
| limit | No | max results, default 10, max 50 | |
| query | Yes | the dish or main ingredients, e.g. 'overnight oats' or 'chicken curry'; express time, rating and nutrition limits with the filters rather than in words | |
| vegan | No | only vegan recipes: vegetarian and no eggs, dairy or honey | |
| feeding | No | how many people are eating, e.g. 10 for a dinner party; from six up, dishes cooked in one vessel (stews, braises, tray bakes, casseroles, soups, roasts) rank ahead of dishes cooked per portion (steaks, burgers, pancakes, stir-fries); nothing is excluded | |
| nut_free | No | only recipes without tree nuts or peanuts; coconut counts as nut-free | |
| max_fat_g | No | maximum grams of fat per serving | |
| dairy_free | No | only recipes without milk, butter, cheese, cream or yogurt | |
| min_rating | No | only recipes rated at least this many stars, e.g. 4.5, source ratings and ask.recipes stars averaged together; recipes nobody has rated yet and private uploads stay in; off unless passed | |
| vegetarian | No | only vegetarian recipes: no meat, poultry, fish, seafood or gelatin in the ingredients | |
| gluten_free | No | only recipes without wheat, barley, rye, oats or products made from them | |
| max_carbs_g | No | maximum grams of carbohydrates per serving | |
| max_sugar_g | No | maximum grams of sugar per serving | |
| min_fiber_g | No | minimum grams of fiber per serving | |
| min_reviews | No | only recipes with at least this many ratings, source and ask.recipes together, e.g. 25; recipes with no rating at all and private uploads stay in; off unless passed | |
| main_protein | No | only recipes whose main protein is one of these: chicken, turkey, duck, goose, quail, pheasant, guinea_fowl, beef (with veal), pork (with ham, bacon and sausage), lamb (with mutton), goat, venison, bison, rabbit, fish, shrimp (with prawns), seafood (other shellfish, squid, octopus), egg, legume (beans, lentils, chickpeas, tofu), none; e.g. ['beef','pork','lamb'] for red meat or ['fish','shrimp','seafood']; judged from the ingredients, so chicken stock alone does not make a chicken dish | |
| max_calories | No | only recipes with at most this many calories per serving, e.g. 300 | |
| min_calories | No | only recipes with at least this many calories per serving | |
| min_protein_g | No | minimum grams of protein per serving, e.g. 10 | |
| batch_friendly | No | true to leave out dishes cooked per portion, for a crowd; recipes not yet classified stay in | |
| max_total_minutes | No | only recipes taking at most this many minutes total | |
| exclude_ingredients | No | ingredients to leave out for this search, whole-word match on the ingredient list, e.g. ['chicken','brussels sprouts'] to avoid repeating what the week already has; nuts, gluten and dairy as a word apply the matching diet filter; the profile's allergens and dislikes stay excluded on top | |