MessNoMore Data Tools › How to Turn a Cooking Video into a Written Recipe
How do you turn a cooking video into a written recipe with amounts, steps and nutrition?
To get a written recipe out of a cooking video, look first where creators put it: the YouTube description, a pinned comment or the TikTok or Reels caption. Then pause the video and note the amounts that are only spoken. When you need many recipes, or structured data with grams, servings and nutrition, Video to Recipe API on Apify reads the description through the official YouTube Data API, transcribes the speech of a video file or parses a pasted caption, and returns one JSON recipe per video.
Where is the recipe in a cooking video?
Usually in more than one place, and rarely complete in any of them:
- Description and pinned comment. On YouTube, many cooks list ingredients under the video, and some put the amounts in a pinned comment instead.
- Caption. On TikTok, Instagram Reels and Xiaohongshu, the recipe is in the caption text, often mixed with hashtags and emoji.
- Speech. Short videos often say the amounts aloud ("two tablespoons of soy sauce") and never write them down.
- The creator's own site. Some videos link to a full written recipe. If there is one, use it: it is the creator's official version.
For one recipe you want to cook tonight, this manual way is enough: copy the text, fill in the spoken amounts while you watch, and check servings before you shop.
Why is writing recipes down by hand slow?
- The parts are scattered. Half the amounts are in the description, the rest are spoken, and servings are rarely stated.
- Units are mixed. One video says grams, the next says cups and "a handful". Scaling to your household size and converting units is arithmetic on every line.
- Nutrition needs a lookup per ingredient. The free official source is USDA FoodData Central: you search each ingredient, pick the right form (raw or cooked, dry pasta or fresh) and weigh it from the amount.
- Shopping lists need merging. Two recipes that both use garlic should give one line, not two.
That is fine for a weekly dinner. It does not work for a meal planner, a grocery app or a food blog that turns hundreds of videos into recipe cards.
How to extract a recipe from a video with an API
Video to Recipe API takes three kinds of input, and you can mix them in one run:
- YouTube links, with your own YouTube Data API key. The key is free, and each video uses 1 of its 10,000 daily quota units. Only the public title and description are read; videos and captions are not downloaded.
- Direct links to audio or video files you have the right to process. The speech is transcribed, then read like a caption.
- Pasted captions from TikTok, Instagram Reels, Facebook or Xiaohongshu. The Actor does not open those platforms.
An AI model turns the texts into a recipe and copies each ingredient line from the source, so you can check every value. Code then scales the amounts, converts units and matches each ingredient to a USDA food. This is part of a real result for a pasted TikTok caption (trimmed to two of its eleven ingredients):
{
"title": "Creamy Tuscan Chicken Pasta",
"cuisine": "italian",
"servings": 3,
"ingredients": [
{
"name": "penne",
"quantity": 250,
"unit": "g",
"groceryAisle": "grains_pasta_rice",
"nutritionMatch": { "fdcId": 169736, "description": "Pasta, dry, enriched", "dataType": "SR Legacy" },
"originalText": "250g penne"
},
{
"name": "chicken breasts",
"quantity": 2,
"unit": "piece",
"estimatedGrams": 340,
"nutritionMatch": { "fdcId": 2646170, "description": "Chicken, breast, boneless, skinless, raw", "dataType": "Foundation" },
"originalText": "2 chicken breasts sliced"
}
],
"nutritionPerServing": { "kcal": 789, "protein_g": 43.7, "fat_g": 35.8, "carbs_g": 73.1, "matchedIngredients": 8, "totalIngredients": 9 },
"confidence": 0.96,
"missingInfo": ["prepMinutes", "cookMinutes", "nutrition:italian herbs"]
}
The same record has eight numbered steps and a shopping list grouped by aisle, from produce to spices. Results can be written in 12 languages, including English, Chinese (always Simplified), Malay, Thai, Vietnamese, Japanese and Spanish. You can call it from your own code:
curl -X POST "https://api.apify.com/v2/acts/messnomore~video-to-recipe/run-sync-get-dataset-items" -H "Authorization: Bearer YOUR_APIFY_TOKEN" -H "Content-Type: application/json" -d '{"items": ["2 eggs, 2 tomatoes, 1 tsp sugar, salt. Fry the eggs, add the tomatoes and sugar, season."], "servings": 2, "unitSystem": "imperial"}'
How much does it cost?
Pay per event: $0.04 per recipe, which includes up to 3 minutes of a media file, plus $0.015 per extra started minute of media and a $0.00005 start fee per run. There is no separate charge for compute. Ten recipes from captions or YouTube links cost $0.40; a 10-minute video file costs $0.04 + 7 × $0.015 = $0.145. Items that are not recipes, links that cannot be read and silent files are skipped and not charged. Apify Bronze, Silver and Gold subscribers get lower prices. On the Apify free plan, a run returns up to 3 recipes and accepts media files up to 5 minutes.
What it does not do
- It does not guess. An amount the video never states stays empty and is listed in
missingInfo. - It does not download from YouTube, TikTok or Instagram. For YouTube it reads only the title and description; for other platforms you paste the caption.
- It does not read text shown only on screen. A recipe that appears only as on-screen text, with no description, caption or speech, cannot be extracted.
- Nutrition is an estimate, and it is left out (
null) when fewer than half of the ingredients can be matched and weighed.
When you publish a recipe you extracted, credit and link the original creator. The tool is not affiliated with YouTube, Google, TikTok or Meta.
FAQ
Can I get the recipe from a YouTube video for free?
Yes, by hand: read the video description and the pinned comment, where creators often put the amounts, and pause the video to write down what is only said aloud. Video to Recipe API does this for $0.04 per recipe and needs your own free YouTube Data API key.
Can I paste a TikTok or Instagram Reels link?
No. Paste the caption text instead, with the video link as sourceUrl if you want to keep it. The Actor does not open pages on TikTok, Instagram or other social platforms. When the amounts are only spoken, give a direct link to a video or audio file you have the right to process and the speech is transcribed.
What happens when the video does not say how much of an ingredient to use?
The amount stays empty and missingInfo lists quantity:<ingredient>, so you know to check before cooking. The Actor does not guess amounts. Servings and times that the video never states are listed there too.
How accurate is the nutrition per serving?
It is an estimate. Each ingredient is matched to a USDA FoodData Central food and weighed from its amount, and nutritionPerServing is null when fewer than half of the ingredients have both an amount and a match. Bone-in meat weights count the bones, so those recipes show more calories than you eat.
Can it scale a recipe or convert grams to cups?
Yes. Set servings to the number you need and every amount is scaled. Set unitSystem to imperial for ounces, pounds, cups and spoons, or metric for grams and millilitres; amounts are rounded the way cooks measure, such as 1/2 cup.
Is it legal to copy a recipe from a video?
A list of ingredients is generally not protected by copyright, but the creator's wording, photos and video are. Credit and link the original creator when you publish a recipe. Video to Recipe API is not affiliated with YouTube, Google, TikTok or Meta.