Docs
Open Lodol
DocumentationIntegrationsAPI

TheCocktailDB

App · Food & Drink · 19 actions

Look up cocktails in TheCocktailDB, the open, crowd-sourced drinks database. Search by name or first letter, pull a drink's full recipe with its ingredients, measures, glassware, photos and instructions in seven languages, and browse by ingredient, category, glass or alcoholic status (including a 'what can I make with these' search across several ingredients at once). Also lists every category, glass, ingredient and alcoholic classification, and serves random, latest and popular drink picks.

Actions

ActionWhat it does
Get a cocktailGet one drink's complete recipe by its id: category, glass, IBA class, tags, every ingredient paired with its measure, instructions in seven languages, and photo URLs in three sizes.
Get a random cocktailGet one randomly chosen drink in full: a ready-made 'cocktail of the day' pick, complete with ingredients, measures and instructions.
Get a random selection of cocktailsGet a handful of randomly chosen drinks in full, for a weekly 'try these' round-up.
Get an ingredientGet one ingredient by its id: what it is, its type, whether it is alcoholic, its ABV and its artwork in four sizes.
List alcoholic classificationsList the alcoholic classifications drinks are filed under (Alcoholic, Non alcoholic, Optional alcohol), ready to feed into the by-alcoholic-status filter.
List categoriesList the categories TheCocktailDB files drinks under, ready to loop over or feed straight into the by-category filter.
List cocktails by alcoholic statusList the drinks in one alcoholic class: Alcoholic, Non alcoholic or Optional alcohol.
List cocktails by categoryList every drink in one category, such as Ordinary Drink, Cocktail, Shot or Punch / Party Drink, as summaries you can chain into Get a cocktail.
List cocktails by first letterList every cocktail whose name begins with one letter or digit, each with its full recipe.
List cocktails by glassList every drink served in one glass, such as a Cocktail glass, Highball glass or Champagne flute: the way to build a menu around the glassware you actually own.
List cocktails by ingredientList every cocktail made with one ingredient, as summaries you can chain into Get a cocktail for the recipe.
List cocktails by several ingredientsList the cocktails that contain every one of the ingredients you pick: the 'what can I make with what's on the shelf' search.
List glassesList every glass TheCocktailDB serves drinks in, ready to loop over or feed straight into the by-glass filter.
List ingredientsList every ingredient TheCocktailDB knows, each with its artwork URLs in four sizes: the bar inventory the by-ingredient filters draw on.
List popular cocktailsGet the drinks TheCocktailDB currently features as popular, in full: a ready-made 'trending cocktails' list.
List recently added cocktailsGet the recently added drinks from TheCocktailDB's V2 feed, in full.
List the latest cocktailsGet the drinks most recently added to TheCocktailDB, in full.
Search cocktailsSearch TheCocktailDB for drinks whose name contains your search text, and get each match in full: category, glass, the ingredient list with measures, instructions in seven languages, and photos in three sizes.
Search ingredientsSearch the ingredient database by name and get what each one is: its description, its type, whether it contains alcohol, its ABV and its artwork in four sizes.

Get a cocktail

Get one drink's complete recipe by its id: category, glass, IBA class, tags, every ingredient paired with its measure, instructions in seven languages, and photo URLs in three sizes. This is the step to run after a filter or search, which return summaries only.

Inputs

Cocktail IDdrink_idtextRequired
TheCocktailDB's id for the drink, as returned by any search or filter step, for example 11007.

Outputs

alcoholictext
Alcoholic classification: Alcoholic, Non alcoholic or Optional alcohol.
alternate_nametext
Another name the drink goes by. Null for most drinks.
categorytext
The category it is filed under, e.g. Ordinary Drink.
creative_commons_confirmedtext
Whether the photo's Creative Commons licence is confirmed: Yes or No.
date_modifiedtext
When the record last changed, YYYY-MM-DD HH:MM:SS.
glasstext
The glass it is served in, e.g. Cocktail glass.
iba_categorytext
Its class on the IBA's official cocktail list, e.g. Contemporary Classics. Null for drinks the IBA does not list.
idtext
TheCocktailDB's id for the drink, e.g. 11007. Get a cocktail takes it.
image_attributiontext
Who to credit for the photo. Null when unrecorded.
image_sourcetext
Where the photo came from. Null when unrecorded.
ingredientslist
The recipe, in the order it is poured. A measure can be empty while the ingredient is real (the salt on a Margarita's rim has no measure).
instructionstext
How to make it, in English.
instructions_by_languageobject
The same instructions in every language TheCocktailDB has them in, keyed en, es, de, fr, it, zh_hans, zh_hant. Only the languages this drink carries are present.
nametext
Drink name, e.g. Margarita.
tagslist
Tags such as IBA or ContemporaryClassic.
thumbnailtext
Full-size drink photo. Null when there is no photo.
thumbnail_largetext
500x500 photo.
thumbnail_mediumtext
350x350 photo.
thumbnail_smalltext
200x200 photo.
urltext
The drink's page on TheCocktailDB. Link to it when you show the recipe.
video_urltext
A video of the drink being made. Null for most drinks.
Example output
{
  "alcoholic": "Alcoholic",
  "alternate_name": null,
  "category": "Ordinary Drink",
  "creative_commons_confirmed": "Yes",
  "date_modified": "2015-08-18 14:42:59",
  "glass": "Cocktail glass",
  "iba_category": "Contemporary Classics",
  "id": "11007",
  "image_attribution": "Cocktailmarler",
  "image_source": "https://commons.wikimedia.org/wiki/File:Klassiche_Margarita.jpg",
  "ingredients": [
    {
      "measure": "1 1/2 oz",
      "name": "Tequila"
    },
    {
      "measure": "1/2 oz",
      "name": "Triple sec"
    },
    {
      "measure": "1 oz",
      "name": "Lime juice"
    },
    {
      "measure": null,
      "name": "Salt"
    }
  ],
  "instructions": "Rub the rim of the glass with the lime slice to make the salt stick to it. Shake the other ingredients with ice, then carefully pour into the glass.",
  "instructions_by_language": {
    "en": "Rub the rim of the glass with the lime slice to make the salt stick to it. Shake the other ingredients with ice, then carefully pour into the glass.",
    "es": "Frota el borde del vaso con la rodaja de lima para que la sal se adhiera a el. Agite los demas ingredientes con hielo y viertalos con cuidado en el vaso."
  },
  "name": "Margarita",
  "tags": [
    "IBA",
    "ContemporaryClassic"
  ],
  "thumbnail": "https://www.thecocktaildb.com/images/media/drink/5noda61589575158.jpg",
  "thumbnail_large": "https://www.thecocktaildb.com/images/media/drink/5noda61589575158.jpg/large",
  "thumbnail_medium": "https://www.thecocktaildb.com/images/media/drink/5noda61589575158.jpg/medium",
  "thumbnail_small": "https://www.thecocktaildb.com/images/media/drink/5noda61589575158.jpg/small",
  "url": "https://www.thecocktaildb.com/drink/11007",
  "video_url": null
}

Get a random cocktail

Get one randomly chosen drink in full: a ready-made 'cocktail of the day' pick, complete with ingredients, measures and instructions.

Inputs

None.

Outputs

alcoholictext
Alcoholic classification: Alcoholic, Non alcoholic or Optional alcohol.
alternate_nametext
Another name the drink goes by. Null for most drinks.
categorytext
The category it is filed under, e.g. Ordinary Drink.
creative_commons_confirmedtext
Whether the photo's Creative Commons licence is confirmed: Yes or No.
date_modifiedtext
When the record last changed, YYYY-MM-DD HH:MM:SS.
glasstext
The glass it is served in, e.g. Cocktail glass.
iba_categorytext
Its class on the IBA's official cocktail list, e.g. Contemporary Classics. Null for drinks the IBA does not list.
idtext
TheCocktailDB's id for the drink, e.g. 11007. Get a cocktail takes it.
image_attributiontext
Who to credit for the photo. Null when unrecorded.
image_sourcetext
Where the photo came from. Null when unrecorded.
ingredientslist
The recipe, in the order it is poured. A measure can be empty while the ingredient is real (the salt on a Margarita's rim has no measure).
instructionstext
How to make it, in English.
instructions_by_languageobject
The same instructions in every language TheCocktailDB has them in, keyed en, es, de, fr, it, zh_hans, zh_hant. Only the languages this drink carries are present.
nametext
Drink name, e.g. Margarita.
tagslist
Tags such as IBA or ContemporaryClassic.
thumbnailtext
Full-size drink photo. Null when there is no photo.
thumbnail_largetext
500x500 photo.
thumbnail_mediumtext
350x350 photo.
thumbnail_smalltext
200x200 photo.
urltext
The drink's page on TheCocktailDB. Link to it when you show the recipe.
video_urltext
A video of the drink being made. Null for most drinks.
Example output
{
  "alcoholic": "Alcoholic",
  "alternate_name": null,
  "category": "Ordinary Drink",
  "creative_commons_confirmed": "Yes",
  "date_modified": "2015-08-18 14:42:59",
  "glass": "Cocktail glass",
  "iba_category": "Contemporary Classics",
  "id": "11007",
  "image_attribution": "Cocktailmarler",
  "image_source": "https://commons.wikimedia.org/wiki/File:Klassiche_Margarita.jpg",
  "ingredients": [
    {
      "measure": "1 1/2 oz",
      "name": "Tequila"
    },
    {
      "measure": "1/2 oz",
      "name": "Triple sec"
    },
    {
      "measure": "1 oz",
      "name": "Lime juice"
    },
    {
      "measure": null,
      "name": "Salt"
    }
  ],
  "instructions": "Rub the rim of the glass with the lime slice to make the salt stick to it. Shake the other ingredients with ice, then carefully pour into the glass.",
  "instructions_by_language": {
    "en": "Rub the rim of the glass with the lime slice to make the salt stick to it. Shake the other ingredients with ice, then carefully pour into the glass.",
    "es": "Frota el borde del vaso con la rodaja de lima para que la sal se adhiera a el. Agite los demas ingredientes con hielo y viertalos con cuidado en el vaso."
  },
  "name": "Margarita",
  "tags": [
    "IBA",
    "ContemporaryClassic"
  ],
  "thumbnail": "https://www.thecocktaildb.com/images/media/drink/5noda61589575158.jpg",
  "thumbnail_large": "https://www.thecocktaildb.com/images/media/drink/5noda61589575158.jpg/large",
  "thumbnail_medium": "https://www.thecocktaildb.com/images/media/drink/5noda61589575158.jpg/medium",
  "thumbnail_small": "https://www.thecocktaildb.com/images/media/drink/5noda61589575158.jpg/small",
  "url": "https://www.thecocktaildb.com/drink/11007",
  "video_url": null
}

Get a random selection of cocktails

Get a handful of randomly chosen drinks in full, for a weekly 'try these' round-up. A Premium API key returns ten; the free test key returns one.

Inputs

None.

Outputs

countnumber
How many records were returned.
drinkslist
The drinks drawn, each with its full recipe.
Example output
{
  "count": 1,
  "drinks": [
    {
      "alcoholic": "Alcoholic",
      "alternate_name": null,
      "category": "Ordinary Drink",
      "creative_commons_confirmed": "Yes",
      "date_modified": "2015-08-18 14:42:59",
      "glass": "Cocktail glass",
      "iba_category": "Contemporary Classics",
      "id": "11007",
      "image_attribution": "Cocktailmarler",
      "image_source": "https://commons.wikimedia.org/wiki/File:Klassiche_Margarita.jpg",
      "ingredients": [
        {
          "measure": "1 1/2 oz",
          "name": "Tequila"
        },
        {
          "measure": "1/2 oz",
          "name": "Triple sec"
        },
        {
          "measure": "1 oz",
          "name": "Lime juice"
        },
        {
          "measure": null,
          "name": "Salt"
        }
      ],
      "instructions": "Rub the rim of the glass with the lime slice to make the salt stick to it. Shake the other ingredients with ice, then carefully pour into the glass.",
      "instructions_by_language": {
        "en": "Rub the rim of the glass with the lime slice to make the salt stick to it. Shake the other ingredients with ice, then carefully pour into the glass.",
        "es": "Frota el borde del vaso con la rodaja de lima para que la sal se adhiera a el. Agite los demas ingredientes con hielo y viertalos con cuidado en el vaso."
      },
      "name": "Margarita",
      "tags": [
        "IBA",
        "ContemporaryClassic"
      ],
      "thumbnail": "https://www.thecocktaildb.com/images/media/drink/5noda61589575158.jpg",
      "thumbnail_large": "https://www.thecocktaildb.com/images/media/drink/5noda61589575158.jpg/large",
      "thumbnail_medium": "https://www.thecocktaildb.com/images/media/drink/5noda61589575158.jpg/medium",
      "thumbnail_small": "https://www.thecocktaildb.com/images/media/drink/5noda61589575158.jpg/small",
      "url": "https://www.thecocktaildb.com/drink/11007",
      "video_url": null
    }
  ]
}

Get an ingredient

Get one ingredient by its id: what it is, its type, whether it is alcoholic, its ABV and its artwork in four sizes.

Inputs

Ingredient IDingredient_idtextRequired
TheCocktailDB's id for the ingredient, as returned by Search ingredients, for example 552.

Outputs

abvnumber
Alcohol by volume, as a percentage. Null when unrecorded or not alcoholic.
descriptiontext
What it is, in a paragraph or two. Null for many ingredients.
idtext
TheCocktailDB's id for the ingredient, e.g. 552. Get an ingredient takes it.
is_alcoholictrue/false
Whether it contains alcohol. Null when unrecorded.
nametext
Ingredient name, e.g. Vodka.
thumbnailtext
700x700 ingredient photo.
thumbnail_largetext
700x700 photo.
thumbnail_mediumtext
350x350 photo.
thumbnail_smalltext
100x100 photo.
typetext
What kind of ingredient it is, e.g. Vodka or Cordial.
urltext
The ingredient's page on TheCocktailDB.
Example output
{
  "abv": 40.0,
  "description": "Vodka is a distilled beverage composed primarily of water and ethanol, sometimes with traces of impurities and flavorings.",
  "id": "1",
  "is_alcoholic": true,
  "name": "Vodka",
  "thumbnail": "https://www.thecocktaildb.com/images/ingredients/Vodka.png",
  "thumbnail_large": "https://www.thecocktaildb.com/images/ingredients/Vodka.png/large",
  "thumbnail_medium": "https://www.thecocktaildb.com/images/ingredients/Vodka.png/medium",
  "thumbnail_small": "https://www.thecocktaildb.com/images/ingredients/Vodka.png/small",
  "type": "Vodka",
  "url": "https://www.thecocktaildb.com/ingredient/1"
}

List alcoholic classifications

List the alcoholic classifications drinks are filed under (Alcoholic, Non alcoholic, Optional alcohol), ready to feed into the by-alcoholic-status filter.

Inputs

None.

Outputs

alcoholic_filterslist
The classifications. List cocktails by alcoholic status takes one of these.
countnumber
How many records were returned.
Example output
{
  "alcoholic_filters": [
    "Alcoholic",
    "Non alcoholic",
    "Optional alcohol"
  ],
  "count": 3
}

List categories

List the categories TheCocktailDB files drinks under, ready to loop over or feed straight into the by-category filter.

Inputs

None.

Outputs

categorieslist
The category names. List cocktails by category takes one of these.
countnumber
How many records were returned.
Example output
{
  "categories": [
    "Cocktail",
    "Ordinary Drink",
    "Shot"
  ],
  "count": 3
}

List cocktails by alcoholic status

List the drinks in one alcoholic class: Alcoholic, Non alcoholic or Optional alcohol. The way to pull a mocktail list for an event.

Inputs

Alcoholic statusalcoholictextRequired
Which class of drinks to list. The list comes from TheCocktailDB, so the spelling always matches.

Outputs

alcoholictext
The classification that was filtered on.
countnumber
How many records were returned.
drinkslist
The matching drinks as name/id/photo summaries. Feed an id into Get a cocktail for the recipe.
Example output
{
  "alcoholic": "Non alcoholic",
  "count": 1,
  "drinks": [
    {
      "id": "11007",
      "name": "Margarita",
      "thumbnail": "https://www.thecocktaildb.com/images/media/drink/5noda61589575158.jpg",
      "thumbnail_large": "https://www.thecocktaildb.com/images/media/drink/5noda61589575158.jpg/large",
      "thumbnail_medium": "https://www.thecocktaildb.com/images/media/drink/5noda61589575158.jpg/medium",
      "thumbnail_small": "https://www.thecocktaildb.com/images/media/drink/5noda61589575158.jpg/small",
      "url": "https://www.thecocktaildb.com/drink/11007"
    }
  ]
}

List cocktails by category

List every drink in one category, such as Ordinary Drink, Cocktail, Shot or Punch / Party Drink, as summaries you can chain into Get a cocktail.

Inputs

CategorycategorytextRequired
The category to list. The list comes from TheCocktailDB, so the spelling always matches.

Outputs

categorytext
The category that was filtered on.
countnumber
How many records were returned.
drinkslist
The matching drinks as name/id/photo summaries. Feed an id into Get a cocktail for the recipe.
Example output
{
  "category": "Ordinary Drink",
  "count": 1,
  "drinks": [
    {
      "id": "11007",
      "name": "Margarita",
      "thumbnail": "https://www.thecocktaildb.com/images/media/drink/5noda61589575158.jpg",
      "thumbnail_large": "https://www.thecocktaildb.com/images/media/drink/5noda61589575158.jpg/large",
      "thumbnail_medium": "https://www.thecocktaildb.com/images/media/drink/5noda61589575158.jpg/medium",
      "thumbnail_small": "https://www.thecocktaildb.com/images/media/drink/5noda61589575158.jpg/small",
      "url": "https://www.thecocktaildb.com/drink/11007"
    }
  ]
}

List cocktails by first letter

List every cocktail whose name begins with one letter or digit, each with its full recipe. Useful for walking the whole database a letter at a time.

Inputs

First characterlettertextRequired
The letter or digit drink names must start with.One of: A, B, C, D, E, F, G, H, I, J, and 26 more.

Outputs

countnumber
How many records were returned.
drinkslist
The matching drinks, each with its full recipe.
lettertext
The character that was listed, upper-cased.
Example output
{
  "count": 1,
  "drinks": [
    {
      "alcoholic": "Alcoholic",
      "alternate_name": null,
      "category": "Ordinary Drink",
      "creative_commons_confirmed": "Yes",
      "date_modified": "2015-08-18 14:42:59",
      "glass": "Cocktail glass",
      "iba_category": "Contemporary Classics",
      "id": "11007",
      "image_attribution": "Cocktailmarler",
      "image_source": "https://commons.wikimedia.org/wiki/File:Klassiche_Margarita.jpg",
      "ingredients": [
        {
          "measure": "1 1/2 oz",
          "name": "Tequila"
        },
        {
          "measure": "1/2 oz",
          "name": "Triple sec"
        },
        {
          "measure": "1 oz",
          "name": "Lime juice"
        },
        {
          "measure": null,
          "name": "Salt"
        }
      ],
      "instructions": "Rub the rim of the glass with the lime slice to make the salt stick to it. Shake the other ingredients with ice, then carefully pour into the glass.",
      "instructions_by_language": {
        "en": "Rub the rim of the glass with the lime slice to make the salt stick to it. Shake the other ingredients with ice, then carefully pour into the glass.",
        "es": "Frota el borde del vaso con la rodaja de lima para que la sal se adhiera a el. Agite los demas ingredientes con hielo y viertalos con cuidado en el vaso."
      },
      "name": "Margarita",
      "tags": [
        "IBA",
        "ContemporaryClassic"
      ],
      "thumbnail": "https://www.thecocktaildb.com/images/media/drink/5noda61589575158.jpg",
      "thumbnail_large": "https://www.thecocktaildb.com/images/media/drink/5noda61589575158.jpg/large",
      "thumbnail_medium": "https://www.thecocktaildb.com/images/media/drink/5noda61589575158.jpg/medium",
      "thumbnail_small": "https://www.thecocktaildb.com/images/media/drink/5noda61589575158.jpg/small",
      "url": "https://www.thecocktaildb.com/drink/11007",
      "video_url": null
    }
  ],
  "letter": "M"
}

List cocktails by glass

List every drink served in one glass, such as a Cocktail glass, Highball glass or Champagne flute: the way to build a menu around the glassware you actually own.

Inputs

GlassglasstextRequired
The glass to list drinks for. The list comes from TheCocktailDB, so the spelling always matches.

Outputs

countnumber
How many records were returned.
drinkslist
The matching drinks as name/id/photo summaries. Feed an id into Get a cocktail for the recipe.
glasstext
The glass that was filtered on.
Example output
{
  "count": 1,
  "drinks": [
    {
      "id": "11007",
      "name": "Margarita",
      "thumbnail": "https://www.thecocktaildb.com/images/media/drink/5noda61589575158.jpg",
      "thumbnail_large": "https://www.thecocktaildb.com/images/media/drink/5noda61589575158.jpg/large",
      "thumbnail_medium": "https://www.thecocktaildb.com/images/media/drink/5noda61589575158.jpg/medium",
      "thumbnail_small": "https://www.thecocktaildb.com/images/media/drink/5noda61589575158.jpg/small",
      "url": "https://www.thecocktaildb.com/drink/11007"
    }
  ],
  "glass": "Cocktail glass"
}

List cocktails by ingredient

List every cocktail made with one ingredient, as summaries you can chain into Get a cocktail for the recipe. Connected with the free test key TheCocktailDB returns a single sample drink here; a Premium API key returns them all.

Inputs

IngredientingredienttextRequired
The ingredient the drink must contain. The list comes from TheCocktailDB, so the spelling always matches.

Outputs

countnumber
How many records were returned.
drinkslist
The matching drinks as name/id/photo summaries. Feed an id into Get a cocktail for the recipe.
ingredienttext
The ingredient that was filtered on.
Example output
{
  "count": 1,
  "drinks": [
    {
      "id": "11007",
      "name": "Margarita",
      "thumbnail": "https://www.thecocktaildb.com/images/media/drink/5noda61589575158.jpg",
      "thumbnail_large": "https://www.thecocktaildb.com/images/media/drink/5noda61589575158.jpg/large",
      "thumbnail_medium": "https://www.thecocktaildb.com/images/media/drink/5noda61589575158.jpg/medium",
      "thumbnail_small": "https://www.thecocktaildb.com/images/media/drink/5noda61589575158.jpg/small",
      "url": "https://www.thecocktaildb.com/drink/11007"
    }
  ],
  "ingredient": "Gin"
}

List cocktails by several ingredients

List the cocktails that contain every one of the ingredients you pick: the 'what can I make with what's on the shelf' search. Needs a Premium API key to return the full set; the free test key returns a sample.

Inputs

IngredientsingredientslistRequired
Every ingredient a drink must contain. Pick at least one; the more you add, the fewer drinks match.

Outputs

countnumber
How many records were returned.
drinkslist
The matching drinks as name/id/photo summaries. Feed an id into Get a cocktail for the recipe.
ingredientslist
The ingredients that were filtered on.
Example output
{
  "count": 1,
  "drinks": [
    {
      "id": "12418",
      "name": "Turf Cocktail",
      "thumbnail": "https://www.thecocktaildb.com/images/media/drink/utypqq1441554367.jpg",
      "thumbnail_large": "https://www.thecocktaildb.com/images/media/drink/utypqq1441554367.jpg/large",
      "thumbnail_medium": "https://www.thecocktaildb.com/images/media/drink/utypqq1441554367.jpg/medium",
      "thumbnail_small": "https://www.thecocktaildb.com/images/media/drink/utypqq1441554367.jpg/small",
      "url": "https://www.thecocktaildb.com/drink/12418"
    }
  ],
  "ingredients": [
    "Dry Vermouth",
    "Gin",
    "Anis"
  ]
}

List glasses

List every glass TheCocktailDB serves drinks in, ready to loop over or feed straight into the by-glass filter.

Inputs

None.

Outputs

countnumber
How many records were returned.
glasseslist
The glass names. List cocktails by glass takes one of these.
Example output
{
  "count": 3,
  "glasses": [
    "Cocktail glass",
    "Collins glass",
    "Highball glass"
  ]
}

List ingredients

List every ingredient TheCocktailDB knows, each with its artwork URLs in four sizes: the bar inventory the by-ingredient filters draw on. The free test key returns the first 100; a Premium API key returns them all.

Inputs

None.

Outputs

countnumber
How many records were returned.
ingredientslist
The ingredients, each with its artwork. List cocktails by ingredient takes one of these names.
Example output
{
  "count": 1,
  "ingredients": [
    {
      "name": "Vodka",
      "thumbnail": "https://www.thecocktaildb.com/images/ingredients/Vodka.png",
      "thumbnail_large": "https://www.thecocktaildb.com/images/ingredients/Vodka.png/large",
      "thumbnail_medium": "https://www.thecocktaildb.com/images/ingredients/Vodka.png/medium",
      "thumbnail_small": "https://www.thecocktaildb.com/images/ingredients/Vodka.png/small"
    }
  ]
}

Get the drinks TheCocktailDB currently features as popular, in full: a ready-made 'trending cocktails' list.

Inputs

None.

Outputs

countnumber
How many records were returned.
drinkslist
The popular drinks, each with its full recipe.
Example output
{
  "count": 1,
  "drinks": [
    {
      "alcoholic": "Alcoholic",
      "alternate_name": null,
      "category": "Ordinary Drink",
      "creative_commons_confirmed": "Yes",
      "date_modified": "2015-08-18 14:42:59",
      "glass": "Cocktail glass",
      "iba_category": "Contemporary Classics",
      "id": "11007",
      "image_attribution": "Cocktailmarler",
      "image_source": "https://commons.wikimedia.org/wiki/File:Klassiche_Margarita.jpg",
      "ingredients": [
        {
          "measure": "1 1/2 oz",
          "name": "Tequila"
        },
        {
          "measure": "1/2 oz",
          "name": "Triple sec"
        },
        {
          "measure": "1 oz",
          "name": "Lime juice"
        },
        {
          "measure": null,
          "name": "Salt"
        }
      ],
      "instructions": "Rub the rim of the glass with the lime slice to make the salt stick to it. Shake the other ingredients with ice, then carefully pour into the glass.",
      "instructions_by_language": {
        "en": "Rub the rim of the glass with the lime slice to make the salt stick to it. Shake the other ingredients with ice, then carefully pour into the glass.",
        "es": "Frota el borde del vaso con la rodaja de lima para que la sal se adhiera a el. Agite los demas ingredientes con hielo y viertalos con cuidado en el vaso."
      },
      "name": "Margarita",
      "tags": [
        "IBA",
        "ContemporaryClassic"
      ],
      "thumbnail": "https://www.thecocktaildb.com/images/media/drink/5noda61589575158.jpg",
      "thumbnail_large": "https://www.thecocktaildb.com/images/media/drink/5noda61589575158.jpg/large",
      "thumbnail_medium": "https://www.thecocktaildb.com/images/media/drink/5noda61589575158.jpg/medium",
      "thumbnail_small": "https://www.thecocktaildb.com/images/media/drink/5noda61589575158.jpg/small",
      "url": "https://www.thecocktaildb.com/drink/11007",
      "video_url": null
    }
  ]
}

List recently added cocktails

Get the recently added drinks from TheCocktailDB's V2 feed, in full. It is a separate endpoint from 'the latest cocktails' and currently serves the same drinks.

Inputs

None.

Outputs

countnumber
How many records were returned.
drinkslist
The recently added drinks, each with its full recipe.
Example output
{
  "count": 1,
  "drinks": [
    {
      "alcoholic": "Alcoholic",
      "alternate_name": null,
      "category": "Ordinary Drink",
      "creative_commons_confirmed": "Yes",
      "date_modified": "2015-08-18 14:42:59",
      "glass": "Cocktail glass",
      "iba_category": "Contemporary Classics",
      "id": "11007",
      "image_attribution": "Cocktailmarler",
      "image_source": "https://commons.wikimedia.org/wiki/File:Klassiche_Margarita.jpg",
      "ingredients": [
        {
          "measure": "1 1/2 oz",
          "name": "Tequila"
        },
        {
          "measure": "1/2 oz",
          "name": "Triple sec"
        },
        {
          "measure": "1 oz",
          "name": "Lime juice"
        },
        {
          "measure": null,
          "name": "Salt"
        }
      ],
      "instructions": "Rub the rim of the glass with the lime slice to make the salt stick to it. Shake the other ingredients with ice, then carefully pour into the glass.",
      "instructions_by_language": {
        "en": "Rub the rim of the glass with the lime slice to make the salt stick to it. Shake the other ingredients with ice, then carefully pour into the glass.",
        "es": "Frota el borde del vaso con la rodaja de lima para que la sal se adhiera a el. Agite los demas ingredientes con hielo y viertalos con cuidado en el vaso."
      },
      "name": "Margarita",
      "tags": [
        "IBA",
        "ContemporaryClassic"
      ],
      "thumbnail": "https://www.thecocktaildb.com/images/media/drink/5noda61589575158.jpg",
      "thumbnail_large": "https://www.thecocktaildb.com/images/media/drink/5noda61589575158.jpg/large",
      "thumbnail_medium": "https://www.thecocktaildb.com/images/media/drink/5noda61589575158.jpg/medium",
      "thumbnail_small": "https://www.thecocktaildb.com/images/media/drink/5noda61589575158.jpg/small",
      "url": "https://www.thecocktaildb.com/drink/11007",
      "video_url": null
    }
  ]
}

List the latest cocktails

Get the drinks most recently added to TheCocktailDB, in full. Run it on a schedule to post whatever is new.

Inputs

None.

Outputs

countnumber
How many records were returned.
drinkslist
The newest drinks, each with its full recipe.
Example output
{
  "count": 1,
  "drinks": [
    {
      "alcoholic": "Alcoholic",
      "alternate_name": null,
      "category": "Ordinary Drink",
      "creative_commons_confirmed": "Yes",
      "date_modified": "2015-08-18 14:42:59",
      "glass": "Cocktail glass",
      "iba_category": "Contemporary Classics",
      "id": "11007",
      "image_attribution": "Cocktailmarler",
      "image_source": "https://commons.wikimedia.org/wiki/File:Klassiche_Margarita.jpg",
      "ingredients": [
        {
          "measure": "1 1/2 oz",
          "name": "Tequila"
        },
        {
          "measure": "1/2 oz",
          "name": "Triple sec"
        },
        {
          "measure": "1 oz",
          "name": "Lime juice"
        },
        {
          "measure": null,
          "name": "Salt"
        }
      ],
      "instructions": "Rub the rim of the glass with the lime slice to make the salt stick to it. Shake the other ingredients with ice, then carefully pour into the glass.",
      "instructions_by_language": {
        "en": "Rub the rim of the glass with the lime slice to make the salt stick to it. Shake the other ingredients with ice, then carefully pour into the glass.",
        "es": "Frota el borde del vaso con la rodaja de lima para que la sal se adhiera a el. Agite los demas ingredientes con hielo y viertalos con cuidado en el vaso."
      },
      "name": "Margarita",
      "tags": [
        "IBA",
        "ContemporaryClassic"
      ],
      "thumbnail": "https://www.thecocktaildb.com/images/media/drink/5noda61589575158.jpg",
      "thumbnail_large": "https://www.thecocktaildb.com/images/media/drink/5noda61589575158.jpg/large",
      "thumbnail_medium": "https://www.thecocktaildb.com/images/media/drink/5noda61589575158.jpg/medium",
      "thumbnail_small": "https://www.thecocktaildb.com/images/media/drink/5noda61589575158.jpg/small",
      "url": "https://www.thecocktaildb.com/drink/11007",
      "video_url": null
    }
  ]
}

Search cocktails

Search TheCocktailDB for drinks whose name contains your search text, and get each match in full: category, glass, the ingredient list with measures, instructions in seven languages, and photos in three sizes.

Inputs

Cocktail namenametextRequired
Full or partial drink name, for example 'Margarita' or 'mojito'.

Outputs

countnumber
How many records were returned.
drinkslist
The matching drinks, each with its full recipe.
querytext
The text that was searched for.
Example output
{
  "count": 1,
  "drinks": [
    {
      "alcoholic": "Alcoholic",
      "alternate_name": null,
      "category": "Ordinary Drink",
      "creative_commons_confirmed": "Yes",
      "date_modified": "2015-08-18 14:42:59",
      "glass": "Cocktail glass",
      "iba_category": "Contemporary Classics",
      "id": "11007",
      "image_attribution": "Cocktailmarler",
      "image_source": "https://commons.wikimedia.org/wiki/File:Klassiche_Margarita.jpg",
      "ingredients": [
        {
          "measure": "1 1/2 oz",
          "name": "Tequila"
        },
        {
          "measure": "1/2 oz",
          "name": "Triple sec"
        },
        {
          "measure": "1 oz",
          "name": "Lime juice"
        },
        {
          "measure": null,
          "name": "Salt"
        }
      ],
      "instructions": "Rub the rim of the glass with the lime slice to make the salt stick to it. Shake the other ingredients with ice, then carefully pour into the glass.",
      "instructions_by_language": {
        "en": "Rub the rim of the glass with the lime slice to make the salt stick to it. Shake the other ingredients with ice, then carefully pour into the glass.",
        "es": "Frota el borde del vaso con la rodaja de lima para que la sal se adhiera a el. Agite los demas ingredientes con hielo y viertalos con cuidado en el vaso."
      },
      "name": "Margarita",
      "tags": [
        "IBA",
        "ContemporaryClassic"
      ],
      "thumbnail": "https://www.thecocktaildb.com/images/media/drink/5noda61589575158.jpg",
      "thumbnail_large": "https://www.thecocktaildb.com/images/media/drink/5noda61589575158.jpg/large",
      "thumbnail_medium": "https://www.thecocktaildb.com/images/media/drink/5noda61589575158.jpg/medium",
      "thumbnail_small": "https://www.thecocktaildb.com/images/media/drink/5noda61589575158.jpg/small",
      "url": "https://www.thecocktaildb.com/drink/11007",
      "video_url": null
    }
  ],
  "query": "margarita"
}

Search ingredients

Search the ingredient database by name and get what each one is: its description, its type, whether it contains alcohol, its ABV and its artwork in four sizes.

Inputs

Ingredient nameingredienttextRequired
Full or partial ingredient name, for example 'vodka' or 'vermouth'.

Outputs

countnumber
How many records were returned.
ingredientslist
The matching ingredients.
querytext
The text that was searched for.
Example output
{
  "count": 1,
  "ingredients": [
    {
      "abv": 40.0,
      "description": "Vodka is a distilled beverage composed primarily of water and ethanol, sometimes with traces of impurities and flavorings.",
      "id": "1",
      "is_alcoholic": true,
      "name": "Vodka",
      "thumbnail": "https://www.thecocktaildb.com/images/ingredients/Vodka.png",
      "thumbnail_large": "https://www.thecocktaildb.com/images/ingredients/Vodka.png/large",
      "thumbnail_medium": "https://www.thecocktaildb.com/images/ingredients/Vodka.png/medium",
      "thumbnail_small": "https://www.thecocktaildb.com/images/ingredients/Vodka.png/small",
      "type": "Vodka",
      "url": "https://www.thecocktaildb.com/ingredient/1"
    }
  ],
  "query": "vodka"
}

TheAudioDB

Previous Page

TheMealDB

Next Page

On this page

ActionsGet a cocktailGet a random cocktailGet a random selection of cocktailsGet an ingredientList alcoholic classificationsList categoriesList cocktails by alcoholic statusList cocktails by categoryList cocktails by first letterList cocktails by glassList cocktails by ingredientList cocktails by several ingredientsList glassesList ingredientsList popular cocktailsList recently added cocktailsList the latest cocktailsSearch cocktailsSearch ingredients