# 🍹 Cocktail & Drink Recipe Intelligence - Drinks API (`benthepythondev/cocktail-intelligence`) Actor

Search and extract cocktail recipes from a database of 600+ drinks. Get ingredients, mixing instructions, glassware, and drink photos. Filter by spirit (vodka, gin, rum, whiskey, tequila), type (alcoholic, non-alcoholic), or ingredient.

- **URL**: https://apify.com/benthepythondev/cocktail-intelligence.md
- **Developed by:** [Ben](https://apify.com/benthepythondev) (community)
- **Categories:** Developer tools, Other, News
- **Stats:** 2 total users, 0 monthly users, 96.8% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $4.00 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## 🍹 Cocktail & Drink Recipe Intelligence — Structured Drink Recipes for Bar & Menu Apps

Get **clean, structured cocktail recipes** — ingredients with measures, mixing instructions, glassware, alcoholic/non-alcoholic flag, photo and IBA tags — for hundreds of drinks, with no scraping and no API key. Search by name, ingredient, category, glass type or alcoholic content, or pull random drinks for "surprise me" features. Every cocktail comes back as one tidy row, ready for a bar app, menu builder or mocktail catalog. Export to JSON/CSV/Excel, run on a schedule, call via API, or connect to Make, Zapier or n8n.

### 🥂 What is the Cocktail & Drink Recipe Intelligence?

It turns a public drinks database (TheCocktailDB) into a structured dataset you can build products on. Tell it how to search — by drink name, ingredient, category, glass, alcoholic type, or random — and it returns full recipes with a parsed `ingredients` array (each ingredient paired with its measure), so mixology sites, hospitality tools and AI bartending assistants get ready-to-use data instead of messy HTML. No paid subscription, no key, no parsing — and IBA official cocktails are included.

#### What data does it extract?

- **Drink name** and stable **drink `id`**
- **Category** (Cocktail, Ordinary Drink, Shot…) and **`alcoholic`** flag (Alcoholic / Non alcoholic / Optional alcohol)
- **`glass`** type (e.g. Cocktail glass, Highball glass)
- **Mixing instructions** in English plus **translations** (`instructions_de`, `instructions_es`, `instructions_fr`, `instructions_it`)
- **Structured `ingredients`** — each item paired with its **measure** (e.g. Tequila / 1 1/2 oz)
- **`ingredients_list`** (names only) and an **`ingredients_count`**
- **Drink photo** (`image` thumbnail URL), **`tags`** (e.g. IBA, ContemporaryClassic) and the **`iba`** classification
- **`video_url`** when available, an `is_creative_commons` flag and an `extracted_at` timestamp

### ⬇️ Input

Pick a search mode and optional filters, then run — no key or login required:

| Field | Description |
|-------|-------------|
| `searchType` | `name`, `ingredient`, `category`, `glass`, `alcoholic`, or `random` |
| `searchQuery` | Search term, e.g. `margarita`, `vodka`, `gin` (default `margarita`) |
| `alcoholicFilter` | `Alcoholic`, `Non_Alcoholic`, or `Optional_Alcohol` |
| `categoryFilter` | Drink category: `Cocktail`, `Ordinary_Drink`, `Shot`, `Coffee_/_Tea`, `Homemade_Liqueur`, etc. |
| `maxResults` | Cap the run (1–200, default 50) |

#### Example input

```json
{
  "searchType": "ingredient",
  "searchQuery": "gin",
  "alcoholicFilter": "Alcoholic",
  "maxResults": 50
}
```

### ⬆️ Output

Every drink is one clean row (view as a **table**, or export **JSON / CSV / Excel**):

```json
{
  "id": "11007",
  "name": "Margarita",
  "category": "Ordinary Drink",
  "iba": "Contemporary Classics",
  "alcoholic": "Alcoholic",
  "glass": "Cocktail glass",
  "instructions": "Rub the rim of the glass with the lime slice to make the salt stick to it...",
  "instructions_de": "Reiben Sie den Rand des Glases mit der Limettenscheibe ab...",
  "instructions_es": "Frote el borde del vaso con la rodaja de lima...",
  "instructions_fr": "Frottez le bord du verre avec la tranche de citron vert...",
  "instructions_it": "Strofina il bordo del bicchiere con la fetta di lime...",
  "image": "https://www.thecocktaildb.com/images/media/drink/5noda61589575158.jpg",
  "tags": ["IBA", "ContemporaryClassic"],
  "video_url": null,
  "ingredients": [
    {"ingredient": "Tequila", "measure": "1 1/2 oz"},
    {"ingredient": "Triple sec", "measure": "1/2 oz"},
    {"ingredient": "Lime juice", "measure": "1 oz"}
  ],
  "ingredients_count": 4,
  "ingredients_list": ["Tequila", "Triple sec", "Lime juice", "Salt"],
  "is_creative_commons": true,
  "extracted_at": "2026-06-26T15:30:00"
}
```

### 💡 Use cases

- 🍸 **Bar & drink apps:** populate your catalog with structured cocktail recipes, glassware and photos in minutes.
- 📋 **Menu & hospitality tools:** build cocktail menus and guides for venues, filtered by spirit or occasion.
- 🧉 **Mocktail & event planning:** generate non-alcoholic drink lists with `alcoholicFilter: "Non_Alcoholic"` for events and dry bars.
- 🤖 **AI bartending assistants:** ground LLM answers in real recipes with exact measures instead of guesswork.

### ❓ FAQ

**How do I search for cocktails?** Choose a `searchType` (name, ingredient, category, glass, alcoholic or random) and a `searchQuery` or filter, then run. You get full recipes with ingredients, measures, instructions and photos.

**Are ingredients structured or just plain text?** Structured. Each ingredient is returned as an object paired with its measure, plus a flat `ingredients_list` and an `ingredients_count` for easy parsing and shopping lists.

**Do I need an API key?** No. There is no key, login or token — just pick a search mode and run.

**Can I find non-alcoholic drinks (mocktails)?** Yes. Set `alcoholicFilter: "Non_Alcoholic"`, or use `searchType: "alcoholic"` to filter by alcoholic content directly.

**Can I search by spirit or glass type?** Yes. Use `searchType: "ingredient"` with a spirit like `gin` or `vodka`, or `searchType: "glass"` to find drinks served in a specific glass.

**Are IBA official cocktails included?** Yes. Many drinks carry an `iba` classification and IBA tags, so you can surface official cocktails.

**Are instructions available in other languages?** Yes. Recipes include German, Spanish, French and Italian instruction fields alongside English.

**How many drinks can it return?** Up to your `maxResults` cap (1–200). Random search returns up to 10 drinks per run for discovery.

**Can I run it on a schedule or via API?** Yes. Schedule recurring runs in Apify, call it via the API/SDK, or connect it to Make, Zapier or n8n to keep your drink catalog updated.

**Is it legal?** It retrieves drink data from a publicly available recipe database. Use it responsibly and respect source attribution where required.

### 🔗 You might also like

- **[Recipe & Meal Intelligence](https://apify.com/benthepythondev/recipe-intelligence)** — hundreds of structured meal recipes
- **[Open Food Facts Product Intelligence](https://apify.com/benthepythondev/open-food-facts-product-intelligence)** — food and drink product data
- **[Open Brewery DB Business Intelligence](https://apify.com/benthepythondev/open-brewery-db-business-intelligence)** — brewery and taproom data
- **[Art Museum Intelligence](https://apify.com/benthepythondev/art-museum-intelligence)** — museum art collections

***

**Keywords:** cocktail scraper, cocktail API, drink recipes, cocktail database, mixology data, ingredients with measures, bar app data, mocktail recipes, non-alcoholic drinks, IBA cocktails, glassware, TheCocktailDB alternative, structured drink recipes, cocktail menu builder, bartending data.

# Actor input Schema

## `searchType` (type: `string`):

How to search for cocktails

## `searchQuery` (type: `string`):

Cocktail name, ingredient, or filter value to search for

## `alcoholicFilter` (type: `string`):

Filter by alcoholic content

## `categoryFilter` (type: `string`):

Filter by drink category

## `maxResults` (type: `integer`):

Maximum number of cocktails to return

## Actor input object example

```json
{
  "searchType": "name",
  "searchQuery": "margarita",
  "maxResults": 50
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {};

// Run the Actor and wait for it to finish
const run = await client.actor("benthepythondev/cocktail-intelligence").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {}

# Run the Actor and wait for it to finish
run = client.actor("benthepythondev/cocktail-intelligence").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{}' |
apify call benthepythondev/cocktail-intelligence --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,benthepythondev/cocktail-intelligence"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/gWrNTcR5eh5v9daVy/builds/7aYQKa0iMMH1XafgC/openapi.json