🍹 CocktailDB Drink Recipe Scraper

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

Scrape modes

Mode	Required input
Search by Name — find cocktails by name	search_term
By Ingredient — all drinks with an ingredient	ingredient
By Category — Cocktail, Shot, Shake, etc.	category
By Glass — Martini glass, Highball, etc.	glass
By Alcoholic — Alcoholic / Non-Alcoholic	alcoholic_filter
Random — get N random cocktails	random_count
Lookup by ID — fetch specific cocktails	cocktail_ids
Browse All — A-Z full database	None
List Filters — available categories, glasses, ingredients	None

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