Pricing

Rating

Developer

Actor stats

Categories

Share

🍹 CocktailDB Drink Recipe Scraper

Scrape cocktail recipes from TheCocktailDB — 636+ cocktails with ingredients, measurements, instructions, and images. Free API, no key needed.

Scrape modes

Quick start examples

Search for margarita:

{"scrape_mode":"search","search_term":"margarita"}

All gin cocktails with full recipes:

{"scrape_mode":"by_ingredient","ingredient":"Gin","include_full_details":true,"max_results":50}

Non-alcoholic drinks:

{"scrape_mode":"by_alcoholic","alcoholic_filter":"Non_Alcoholic"}

10 random cocktails:

{"scrape_mode":"random","random_count":10}

Browse the full database:

{"scrape_mode":"browse_all","max_results":300}

Output

{
"id":"11007",
"name":"Margarita",
"category":"Ordinary Drink",
"glass":"Cocktail glass",
"alcoholic":"Alcoholic",
"instructions":"Rub the rim of the glass with the lime slice to make the salt stick to it. Take care to moisten only the outer rim...",
"instructions_es":"Frote el borde del vaso con la rodaja de lima...",
"image":"https://www.thecocktaildb.com/images/media/drink/5noda61606781084.jpg",
"ingredients":[
{"ingredient":"Tequila","measure":"1 1/2 oz","image_small":"https://...Tequila-Small.png"},
{"ingredient":"Triple sec","measure":"1/2 oz","image_small":"https://...Triple sec-Small.png"},
{"ingredient":"Lime juice","measure":"1 oz","image_small":"https://...Lime juice-Small.png"},
{"ingredient":"Salt","measure":"","image_small":"https://...Salt-Small.png"}
],
"ingredient_count":4,
"ingredient_list":"Tequila, Triple sec, Lime juice, Salt",
"tags":["IBA","Classic"],
"iba_category":"Contemporary Classics"
}

Categories

Ordinary_Drink · Cocktail · Shake · Shot · Coffee_/_Tea · Homemade_Liqueur · Punch_/_Party_Drink · Beer · Soft_Drink

Popular ingredients

Gin · Vodka · Rum · Tequila · Whiskey · Bourbon · Brandy · Champagne · Kahlua · Lime juice · Lemon juice · Triple sec · Grenadine · Cream

Key features

• Full recipe extraction — ingredients, measurements, instructions in 5 languages
• Ingredient images — auto-generated URLs for every ingredient (small + medium)
• Cocktail images — high-quality drink photos + preview thumbnails
• Filter modes enrich — toggle include_full_details to get full recipes from any filter
• Random with dedup — fetches unique random cocktails (no repeats)
• Browse A-Z — scrape the entire 636+ cocktail database
• Runs in ~5-30 seconds, costs < $0.01 per run

Limitations

• Free API key "1" is for development/educational use
• ~636 cocktails and ~489 ingredients in the database
• Some API methods (popular, latest, multi-ingredient filter) are premium-only
• Rate limit: be respectful, actor adds 1s delays between requests