🍹 Cocktail Drinks Scraper - Recipes, Ingredients, Glasses

🚀 Pull cocktail recipes with ingredients, mixing instructions in 6 languages, glass type, IBA classification, alcoholic flag, image, and video.

🕒 Last updated: 2026-05-08 · 📊 20+ fields per record · 11 categories · 5 glass types · ingredients, measures, instructions in 6 languages · search by name, category, glass, ingredient, alcoholic / non-alcoholic, or random

The Cocktail Drinks Scraper pulls full cocktail recipes from TheCocktailDB open dataset. Output includes the drink name and alternate name, category, alcoholic / non-alcoholic flag, glass type, IBA classification, tags, image URL, instructions in English, Spanish, German, French, Italian, and Chinese (Simplified + Traditional), structured ingredients array (up to 15 ingredient + measure pairs), and YouTube video URL.

Eight search modes in one Actor: free-text name search, browse by category, browse by glass, browse by ingredient, alcoholic / non-alcoholic toggle, random drink, popular drink, and direct lookup by ID. Run a single category to pull every Ordinary Drink, or every Cocktail, or pull random drinks for inspiration.

🎯 Target Audience	💡 Primary Use Cases
Bartender app builders, recipe apps, hospitality vendors, mixology bloggers, ML datasets, party planners	Bar inventory + recipe apps, mixology blogs, party-planning tools, ingredient-driven recommendation, drink-vocabulary training

---

📋 What the Cocktail Drinks Scraper - Recipes, Ingredients, Glasses does

Five filtering workflows in a single run:

• 🔍 Name search. Free-text drink search across the dataset.
• 🥃 Filter by category. Ordinary Drink, Cocktail, Shot, Beer, Punch / Party Drink, Coffee / Tea, etc.
• 🥂 Filter by glass. Highball, Old-fashioned, Cocktail, Shot, Wine, etc.
• 🍋 Filter by ingredient. Find every drink using gin, vodka, lime juice, etc.
• 🌍 6 languages. Mixing instructions in EN / ES / DE / FR / IT / ZH-HANS / ZH-HANT.

💡 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, byGlass, byIngredient, byAlcoholic, popular, random, byId.
query	string	"Ordinary Drink"	Search term or filter value.

Example: every ordinary drink.

{
    "maxItems": 100,
    "mode": "byCategory",
    "query": "Ordinary Drink"
}

Example: non-alcoholic drinks.

{
    "maxItems": 50,
    "mode": "byAlcoholic",
    "query": "Non_Alcoholic"
}

---

📊 Output

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

🧾 Schema

Field	Type	Example
🖼️ thumbnail	string	"https://www.thecocktaildb.com/images/media/drink/.../tx5pe11572005052.jpg"
🆔 drinkId	number	11007
📛 name	string	"Margarita"
🏷️ category	string	"Ordinary Drink"
🍸 glass	string	"Cocktail glass"
🥃 alcoholic	string	"Alcoholic"
🏛️ iba	string	"Contemporary classics"
📋 instructions	string	"Rub the rim of the glass with the lime slice..."
📋 instructionsEs	string	"Frota el borde del vaso con la rodaja de lima..."
📋 instructionsDe	string	"Reiben Sie den Rand des Glases..."
🥬 ingredients	array of objects	[{"ingredient":"Tequila","measure":"1 1/2 oz"},...]
🔢 ingredientCount	number	4
📺 videoUrl	string	null
🌐 cocktaildbUrl	string	"https://www.thecocktaildb.com/drink/11007"

📦 Sample records

---

✨ Why choose this Actor

	Capability
🌍	Multilingual instructions. Instructions in 6 to 8 languages per drink.
🏛️	IBA classifications. International Bartenders Association tier per drink.
🥬	Structured ingredients. Ingredient + measure pairs as parseable arrays.
🥂	Filter by glass type. Find every Highball, every Cocktail glass, etc.
🆓	No API key. Open community drinks dataset.

---

📈 How it compares to alternatives

Approach	Cost	Coverage	Refresh	Filters	Setup
⭐ This Actor	$5 free credit	Open cocktails	Live per run	8 modes	⚡ 2 min
Mr Boston (paid)	$$	Larger	Static book	No	🐢 Manual
Difford's Guide (paid)	$$	Larger	Live	Yes	🐢 Account
Bar-blog 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 Cocktail Drinks Scraper - Recipes, Ingredients, Glasses 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

🍸 Bar + Hospitality Cocktail-menu builders Bartender training apps Inventory vs recipe apps Mixology suggestions	📱 Recipe + Drink Apps Cocktail catalog UI Drink-pairing recommendations Party-planning tools What-to-mix bots
🎓 Education Bartender-school materials Cocktail-history corpora Multilingual mixology lessons Sommelier training	📰 Lifestyle Content Drink-blog bases Newsletter cocktails Holiday menu posts Cocktail-of-the-day apps

---

🔌 Automating Cocktail Drinks Scraper - Recipes, Ingredients, Glasses

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 Drink-history datasets Cross-cultural beverage studies Reproducible cocktail corpora Linguistic studies on mixing	🎨 Personal and creative Personal bar logbooks Cocktail-blog backbones Side projects with drink data Mixology zines
🤝 Non-profit and civic Responsible-drinking education Free mocktail catalogs Heritage-cocktail preservation Bartender vocational programs	🧪 Experimentation Train ingredient-graph models Prototype mixology agents Build pantry-based drink finders Test recommendation logic

---

🤖 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, byGlass, byIngredient, byAlcoholic, popular, random, or byId) and provide the relevant value. The Actor queries TheCocktailDB and returns each drink.

📊 How many fields per record?

Up to 22, including drink name, category, glass, alcoholic flag, IBA tier, instructions in 6 to 8 languages, and a structured ingredients array.

🌍 How many languages?

Instructions in EN, ES, DE, FR, IT, ZH-HANS, ZH-HANT (when available; not every drink has all translations).

🥬 What does the ingredients array look like?

Up to 15 ingredient + measure pairs (e.g. {ingredient: 'Tequila', measure: '1 1/2 oz'}).

🥂 How many glass types?

20+ in the dataset, covering Highball, Old-fashioned, Cocktail, Shot, Wine, Beer, Coupe, Margarita, etc.

🆓 Do I need an API key?

No. TheCocktailDB is open.

🔁 Can I schedule runs?

Yes. Apify Schedules supports any cron interval.

⚖️ Is this data free?

Yes. TheCocktailDB publishes drinks under Creative Commons.

📺 Are videos always included?

No. YouTube URL is included when the drink has a paired video.

💳 Do I need a paid Apify plan?

No. The free plan covers preview runs (10 records).

---

🔌 Integrate with any app

Cocktail Drinks Scraper - Recipes, Ingredients, Glasses 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

• 🍳 Meal Recipes - Recipes with ingredients, instructions, image, video
• 🧠 Open Trivia DB Questions - Trivia questions across 24 categories with answers
• 📚 Wikipedia Article Summary - Pull Wikipedia summaries with thumbnail, extract, geo and Wikidata link
• 🌍 REST Countries Reference Data - Every country with flag, capital, currency, languages
• 📚 Project Gutenberg Books - 75,000+ free public-domain books

💡 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 TheCocktailDB, its maintainers, the International Bartenders Association, or any individual cocktail author. All trademarks mentioned are the property of their respective owners. Only publicly available open data is collected.