What does a cocktail include?

Name, category, whether it is alcoholic, ingredients with measures, glassware, garnish and step-by-step instructions.

46 classics and mocktails, curated rather than crowd-sourced, so every recipe is complete.

Can I search by ingredient?

Yes. Filter by ingredient, category or alcoholic flag, search by name, or browse the ingredient index.

Are the recipes original?

Ingredient lists are the classic specifications; the instructions are written for this API.

What does a call cost?

1 token. The free plan covers 500 lookups a month.

FoodMAINTAINED1 token / call

Cocktails API

46 classic cocktails and mocktails with ingredients, measures, glassware, garnish and instructions

A curated library of 46 classic cocktails and mocktails with ingredients, measures, glassware, garnish, and instructions. Search by name, filter by category, alcoholic/non-alcoholic, or ingredient, pull a random round, or browse the ingredient index.

Every call needs an X-Api-Key header. A free key includes 500 tokens a month, no card required. 1 token per call, so the free plan covers about 500 calls a month.

Start free — 500 tokens / mo →See all plans

No credit card requiredAccess to 125+ APIsCancel anytime

response.json

{
  "name": "Margarita",
  "slug": "margarita",
  "category": "Cocktail",
  "glass": "Cocktail glass",
  "alcoholic": true,
  "ingredients": [
    {
      "name": "Tequila 100% Agave",
      "measure": "50 ml"
    },
    {
      "name": "Triple Sec",
      "measure": "20 ml"
    },
    {
      "name": "Freshly Squeezed Lime Juice",
      "measure": "15 ml"
    }
  ],
  "garnish": "Half salt rim (Optional).",
  "instructions": "Shake the ingredients hard with ice and strain into a cocktail glass."
}

Production Ready: Battle-tested infrastructure with a 99.9% uptime SLA. Rate limits are generous, responses are consistent.
Simple Integration: Standard REST + JSON. Works with any HTTP client. Copy-ready code snippets in 4 languages.
One Key, 125+ APIs: Your DataAndAPIs subscription unlocks every API on the platform — anime, finance, sports, and more.

Use cases for Cocktails API

Build a bar menu or cocktail finder filtered by ingredient or alcohol content.
Show a random drink of the night with its recipe.
Power a what-can-I-make feature from the ingredient index.
Add drink pairings to a recipes or events app.

Cocktails API endpoints

Every endpoint with its parameters and a real example response.

OpenAPI definition Postman workspace

GETGet Cocktail
GETList Cocktails
GETList Ingredients
GETRandom Cocktail

GETGet Cocktail

https://api-cocktails.dataandapis.com/v1/cocktails/{slug}

Path parameters

Parameter	Example
slug	margarita	Required

Example request

curl "https://api-cocktails.dataandapis.com/v1/cocktails/margarita" \
  -H "X-Api-Key: YOUR_API_KEY"

Example response

{
  "name": "Margarita",
  "slug": "margarita",
  "category": "Sour",
  "glass": "Margarita glass",
  "alcoholic": true,
  "ingredients": [
    {
      "name": "Tequila",
      "measure": "2 oz"
    },
    {
      "name": "Lime juice",
      "measure": "1 oz"
    },
    {
      "name": "Triple sec",
      "measure": "1 oz"
    }
  ],
  "garnish": "Salt rim and a lime wheel",
  "instructions": "Shake all ingredients with ice and strain into a salt-rimmed glass over fresh ice.",
  "tags": [
    "tequila",
    "citrus",
    "iba"
  ]
}

GETList Cocktails

https://api-cocktails.dataandapis.com/v1/cocktails

Query parameters

Parameter	Example
alcoholic	false	Optional
category	Sour	Optional
ingredient	gin	Optional
q	margarita	Optional

Example request

curl "https://api-cocktails.dataandapis.com/v1/cocktails?alcoholic=false&category=Sour&ingredient=gin&q=margarita" \
  -H "X-Api-Key: YOUR_API_KEY"

Example response

{
  "total": 1,
  "page": 1,
  "limit": 20,
  "count": 1,
  "results": [
    {
      "name": "Margarita",
      "slug": "margarita",
      "category": "Sour",
      "glass": "Margarita glass",
      "alcoholic": true,
      "ingredients": [
        {
          "name": "Tequila",
          "measure": "2 oz"
        },
        {
          "name": "Lime juice",
          "measure": "1 oz"
        },
        {
          "name": "Triple sec",
          "measure": "1 oz"
        }
      ],
      "garnish": "Salt rim and a lime wheel",
      "instructions": "Shake all ingredients with ice and strain into a salt-rimmed glass over fresh ice.",
…

Show full response

{
  "total": 1,
  "page": 1,
  "limit": 20,
  "count": 1,
  "results": [
    {
      "name": "Margarita",
      "slug": "margarita",
      "category": "Sour",
      "glass": "Margarita glass",
      "alcoholic": true,
      "ingredients": [
        {
          "name": "Tequila",
          "measure": "2 oz"
        },
        {
          "name": "Lime juice",
          "measure": "1 oz"
        },
        {
          "name": "Triple sec",
          "measure": "1 oz"
        }
      ],
      "garnish": "Salt rim and a lime wheel",
      "instructions": "Shake all ingredients with ice and strain into a salt-rimmed glass over fresh ice.",
      "tags": [
        "tequila",
        "citrus",
        "iba"
      ]
    }
  ]
}

GETList Ingredients

https://api-cocktails.dataandapis.com/v1/cocktails/ingredients

This endpoint takes no parameters.

Example request

curl "https://api-cocktails.dataandapis.com/v1/cocktails/ingredients" \
  -H "X-Api-Key: YOUR_API_KEY"

Example response

{
  "count": 70,
  "ingredients": [
    {
      "name": "Lime juice",
      "count": 13
    },
    {
      "name": "Gin",
      "count": 12
    },
    {
      "name": "Lemon juice",
      "count": 9
    }
  ]
}

GETRandom Cocktail

https://api-cocktails.dataandapis.com/v1/cocktails/random

Query parameters

Parameter	Example
amount	1	Optional

Example request

curl "https://api-cocktails.dataandapis.com/v1/cocktails/random?amount=1" \
  -H "X-Api-Key: YOUR_API_KEY"

Example response

{
  "count": 1,
  "results": [
    {
      "name": "Godfather",
      "slug": "godfather",
      "category": "Cocktail",
      "glass": "Old-fashioned glass",
      "alcoholic": true,
      "ingredients": [
        {
          "name": "Scotch",
          "measure": "1 1/2 oz"
        },
        {
          "name": "Amaretto",
          "measure": "3/4 oz"
        }
      ],
      "garnish": "",
      "instructions": "Stir the ingredients with ice until well chilled, then strain into an old-fashioned glass."
    }
  ]
}

Where the data comes from

Source: Curated cocktail set bundled in the worker.
Freshness: Extended with API releases.

One install. Every endpoint.

No proprietary SDKs needed. Any HTTP client works. Pick your language and paste.

3languages

4endpoints

RESTarchitecture

1key for all APIs

Fully typed responses — auto-completion in your IDE
Tracks the API in lockstep — new endpoints land same day
One key works across 125+ APIs on the platform

import axios from 'axios';

const { data } = await axios.get(
  'https://api-cocktails.dataandapis.com/v1/cocktails/{slug}',
  { headers: { 'X-Api-Key': process.env.API_KEY } }
);

Cocktails API · X-Api-Key

Explore the endpoints

Browse request parameters and inspect live example responses.

Available Endpoints

Request Parameters

API URL

Headers

X-Api-Key

Path Parameters

slug

Target:

Client:

import axios from 'axios';

const url = 'https://api-cocktails.dataandapis.com/v1/cocktails/{slug}';
const { data } = await axios.get(url, {
  headers: { 'X-Api-Key': 'YOUR_API_KEY' }
});