🍳 Meal Recipes Scraper - Categories, Ingredients, Areas

🚀 Pull meal recipes with ingredients, instructions, image, video, area, category, and tags. 6 search modes for any cuisine.

🕒 Last updated: 2026-05-08 · 📊 17 fields per record · 14 categories · 195 areas · ingredients, measures, instructions, image, YouTube video · search by name, ingredient, area, category, or random

The Meal Recipes Scraper pulls full recipes from TheMealDB open recipe dataset. Output includes the meal name and alternate name, category, area / cuisine, country, tags, image URL, full step-by-step instructions, source URL, YouTube video URL, image source, Creative Commons confirmation, and a structured ingredients array (up to 20 ingredient + measure pairs).

Six search modes in one Actor: free-text name search, browse by category (Beef, Chicken, Dessert, Lamb, Pasta, Pork, Seafood, Vegan, etc), browse by area / cuisine (Italian, Mexican, Thai, Japanese...), browse by ingredient, random meal, and direct lookup by ID. Run a single category to scrape every dessert in the database, or pull random meals for daily inspiration.

🎯 Target Audience	💡 Primary Use Cases
Recipe app builders, food bloggers, meal-planning startups, cooking-content marketers, ML datasets for food, hobbyist cooks	Recipe app catalogs, meal-planning tools, ingredient-driven recommendation, what-to-cook bots, food blogs, cooking-vocabulary training

---

📋 What the Meal Recipes Scraper - Categories, Ingredients, Areas does

Five filtering workflows in a single run:

• 🔍 Name search. Free-text recipe search across the dataset.
• 🥩 Filter by category. 14 categories: Beef, Chicken, Dessert, Lamb, Pasta, Pork, Seafood, Vegan, Vegetarian, Side, Starter, Breakfast, Goat, Miscellaneous.
• 🌎 Filter by area. 195 cuisines / countries: Italian, Mexican, Japanese, Thai, Indian, French, etc.
• 🥬 Filter by ingredient. Find every recipe using chicken, garlic, parmesan, etc.
• 🎲 Random + lookup. Pull a random meal or fetch by ID directly.

💡 Why it matters: clean, server-side filtering and fresh data on every run.

---

🎬 Full Demo

🚧 Coming soon: a 3-minute walkthrough showing how to go from sign-up to a downloaded dataset.

---

⚙️ Input

Input	Type	Default	Behavior
maxItems	integer	10	Records to return. Free plan caps at 10, paid plan up to 1,000,000.
mode	string	"byCategory"	search, byCategory, byArea, byIngredient, random, byId.
query	string	"Chicken"	Search term or filter value (slug for byCategory / byArea / byIngredient).

Example: every chicken recipe.

{
    "maxItems": 100,
    "mode": "byCategory",
    "query": "Chicken"
}

Example: Italian cuisine.

{
    "maxItems": 50,
    "mode": "byArea",
    "query": "Italian"
}

---

📊 Output

Each record contains 17 fields. Download as CSV, Excel, JSON, or XML.

🧾 Schema

Field	Type	Example
🖼️ thumbnail	string	"https://www.themealdb.com/images/media/meals/wuxrtu1483564410.jpg"
🆔 mealId	number	52772
📛 name	string	"Teriyaki Chicken Casserole"
🏷️ category	string	"Chicken"
🌎 area	string	"Japanese"
🏷️ tags	array	["Meat","Casserole"]
📋 instructions	string	"Preheat oven to 350° F..."
🥬 ingredients	array of objects	[{"ingredient":"chicken","measure":"3/4 cup"},...]
📝 ingredientsText	string	"3/4 cup soy sauce, 1/2 cup water..."
🔢 ingredientCount	number	11
📺 youtubeUrl	string	"https://www.youtube.com/watch?v=4aZr5hZXP_s"
🌐 sourceUrl	string	"https://www.example.com/recipe"
🌐 mealdbUrl	string	"https://www.themealdb.com/meal/52772"

📦 Sample records

---

✨ Why choose this Actor

	Capability
🌍	Global cuisine coverage. 195 areas + 14 categories spanning every major food tradition.
🥬	Structured ingredients. Up to 20 ingredient + measure pairs as a structured array, not a blob of text.
📺	Video walkthroughs. YouTube URL per recipe (when available).
🆓	No API key. Open community recipe dataset.
⚡	Fast. Hundreds of recipes per minute.

---

📈 How it compares to alternatives

Approach	Cost	Coverage	Refresh	Filters	Setup
⭐ This Actor	$5 free credit	Open recipes	Live per run	6 modes	⚡ 2 min
Edamam (paid)	$$/month	Larger	Live	Yes	🐢 Account
Spoonacular (paid)	$$/month	Larger	Live	Yes	🐢 Account
Recipe-site scraping	Free	All	Live	DIY	🐢 Days

---

🚀 How to use

1. 📝 Sign up. Create a free account with $5 credit (takes 2 minutes).
2. 🌐 Open the Actor. Find the Meal Recipes Scraper - Categories, Ingredients, Areas on the Apify Store.
3. 🎯 Set input. Pick filters and maxItems.
4. 🚀 Run it. Click Start.
5. 📥 Download. Grab results in the Dataset tab as CSV, Excel, JSON, or XML.

⏱️ Total time from signup to dataset: 3-5 minutes. No coding required.

---

💼 Business use cases

📱 Recipe Apps + Sites Build a recipe catalog Meal-planning app data Ingredient-driven recommendation What-to-cook chatbots	🤖 ML + AI Fine-tune cooking-instruction models Train ingredient embeddings Build food-classification datasets Vocabulary corpora for cooking
📰 Food Content Blog post bases Newsletter recipes Meal-prep social posts Cooking-tutorial scripts	🎓 Education Culinary-school course materials Nutrition-class examples Language-learning food vocabulary Hobbyist cooking sites

---

🔌 Automating Meal Recipes Scraper - Categories, Ingredients, Areas

Control the scraper programmatically:

• 🟢 Node.js. Install the apify-client NPM package.
• 🐍 Python. Use the apify-client PyPI package.
• 📚 See the Apify API documentation for full details.

The Apify Schedules feature lets you trigger this Actor on any cron interval.

---

🌟 Beyond business use cases

Data like this powers more than commercial workflows.

🎓 Research and academia Food anthropology datasets Cuisine-temporal studies Nutrition curriculum sourcing Reproducible recipe corpora	🎨 Personal and creative Personal recipe boxes Cooking-blog backbones Side projects with food data Family-recipe digitalization
🤝 Non-profit and civic Community-cookbook projects Food-bank recipe sharing Heritage-cuisine preservation Free cooking-education content	🧪 Experimentation Train recipe-generation models Prototype meal-planner apps Build ingredient-graph systems Test pantry-based search

---

🤖 Ask an AI assistant about this scraper

Open a ready-to-send prompt in the AI of your choice:

• 💬 ChatGPT
• 🧠 Claude
• 🔍 Perplexity
• 🅒 Copilot

---

❓ Frequently Asked Questions

🧩 How does it work?

Pick a mode (search, byCategory, byArea, byIngredient, random, or byId) and provide the relevant value. The Actor queries TheMealDB and returns each meal record.

📊 How many fields per record?

17, including name, category, area, tags, image URL, YouTube URL, full instructions, structured ingredients, ingredient count, and source URL.

🥬 What does the ingredients array look like?

Up to 20 ingredient + measure pairs (e.g. {ingredient: 'chicken', measure: '3/4 cup'}). Easier to parse than the original 40-field format.

🌎 How many cuisines are covered?

195 areas based on TheMealDB's geography list. Note: some areas have very few recipes.

🏷️ How many categories?

14: Beef, Chicken, Dessert, Lamb, Pasta, Pork, Seafood, Vegan, Vegetarian, Side, Starter, Breakfast, Goat, Miscellaneous.

📺 Are videos always included?

No. YouTube URL is included when the recipe has a paired video, which is most but not all.

🆓 Do I need an API key?

No. TheMealDB is open.

🔁 Can I schedule runs?

Yes. Apify Schedules supports any cron interval.

⚖️ Is this data free?

Yes. TheMealDB publishes recipes under Creative Commons.

💳 Do I need a paid Apify plan?

No. The free plan covers preview runs (10 records). A paid plan unlocks higher item counts.

---

🔌 Integrate with any app

Meal Recipes Scraper - Categories, Ingredients, Areas connects to any cloud service via Apify integrations:

• Make - Automate multi-step workflows
• Zapier - Connect with 5,000+ apps
• Slack - Get run notifications
• Airbyte - Pipe data into your warehouse
• GitHub - Trigger runs from commits
• Google Drive - Export datasets to Sheets

---

🔗 Recommended Actors

• 🍹 Cocktail Drinks - Cocktail recipes with ingredients, glass, IBA, image
• 🧠 Open Trivia DB Questions - Trivia questions across 24 categories with answers
• 🌍 Wikivoyage Travel Articles - Wikivoyage city and country articles with image, geo
• 📚 Wikipedia Article Summary - Pull Wikipedia summaries with thumbnail, extract, geo and Wikidata link
• 🌍 REST Countries Reference Data - Every country with flag, capital, currency, languages

💡 Pro Tip: browse the complete ParseForge collection for more reference-data scrapers.

---

🆘 Need Help? Open our contact form to request a new scraper, propose a custom data project, or report an issue.

---

⚠️ Disclaimer: this Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by TheMealDB, its maintainers, or any individual recipe author. All trademarks mentioned are the property of their respective owners. Only publicly available open data is collected.