ask.recipes

Add or restock pantry items from what the user says in passing: "bought rice and two chickens", "here's what's in the fridge". An item already in the pantry gets the new quantity. Names are matched loosely, so 'Eggs' and 'eggs' are the same item. Returns the whole pantry after the change.

add_to_pantry

Create a share link for one of the user's uploaded recipes, for "send this to my wife", "share it with Tom", "give me a link", "add this to MacroFactor". Returns a share.ask.recipes URL that opens without an account and is not listed or indexed; the page credits the recipe's original source and carries schema.org Recipe markup, so apps that import a recipe from a link can read it. Only recipes the user uploaded can be shared; for other recipes the source link is the thing to share.

share_recipe

Find recipes that use ingredients the user already has: leftovers, a full fridge, an ingredient about to turn. Ranks by how many of those ingredients a recipe uses and how few extra ones it needs. The user's pantry counts as on hand too, so a recipe that only needs pantry staples on top of what was passed ranks as nearly complete; with no ingredients passed it cooks from the pantry alone, for "what can I make with what I have". Takes the same diet, nutrition and exclude_ingredients filters as search_recipes. Each result links to its source. The user's profile, when set in the app, excludes allergens and dislikes, keeps its diets on and supplies the default time budget; pass max_total_minutes=-1 to lift it.

find_by_ingredients

Get one recipe in full: ingredients, step-by-step instructions, times, yield, nutrition and its source link. For when the user picks a recipe from a search or asks how to make it. Pass servings to scale the ingredient quantities, e.g. for meal prep or a crowd; nutrition_for says whether the nutrition numbers are per serving or for the whole yield.

get_recipe

List the recipes the user saved in ask.recipes, for "my recipes", "what did I save", "the one I kept last week". Not the Thermomix / Bimby / Cookidoo side; that is list_cookidoo_recipes.

list_saved

Take items out of the pantry for "used the last onions", "we're out of milk", or empty it with all=true when the user lists what is in the kitchen now, then add_to_pantry. Names are matched loosely. Returns the whole pantry after the change.

remove_from_pantry

Save a recipe to the user's collection, for "save that one", "keep this", "add it to my recipes". Saving the same recipe twice has no further effect.

save_recipe

Search human-rated recipes for a what-to-cook or what-to-eat question: dinner tonight, cooking for guests, a quick weeknight meal, a protein or calorie target, macros for a cut or a bulk, meal prep for the week. Every result links to its source. Filters by time, rating, review count, diet (vegetarian, vegan, gluten_free, dairy_free, nut_free, judged from the ingredient list) and nutrition (calories, protein, fat, carbs, sugar, fiber per serving as reported by the source). A nutrition filter only returns recipes whose yield is stated in servings, so the numbers are per serving; recipes without nutrition data are excluded. Results rank by how many people rated them; min_rating and min_reviews cut below a threshold only when passed. exclude_ingredients leaves out recipes using any of the ingredients named, for building a week without repeats. The user's profile, when they set one in the app, applies on top: allergens and dislikes are always excluded, its diets are always on, and its time budget is the default when max_total_minutes is not passed; pass max_total_minutes=-1 to lift it.

search_recipes

Add a recipe the user supplies themselves: pasted in, dictated, a family recipe they want kept, or a web page they point at. For a web page, pass the page's raw HTML or its JSON-LD as markup together with source_url; the server extracts the facts. Each call creates a new private recipe, visible only to this user in searches and saves.

upload_recipe

List what the user has told you is in their kitchen: pantry, fridge and freezer, with quantities when they gave one. For "what do I have", before suggesting a shopping list, or to check an ingredient before recommending a recipe. find_by_ingredients with no ingredients searches from this list directly.

get_pantry