Holiday Sale! Get over 30% off when you subscribe to an annual plan!

Cocktail API

The Cocktail API allows you to search thousands of cocktail recipes by name or ingredients.

(4.4)

From 7,417 users

API Status

Online - All Systems Operational

API Response Times

Average
P50
P75
P90
P95
188ms236ms249ms623ms1078ms

Didn't find what you were looking for? Suggest an improvement

/v1/cocktail GET

https://api.api-ninjas.com/v1/cocktail

Returns up to 10 cocktail recipes matching the search parameters.

Parameters

At least one of the following parameters must be present:

  • name  optional

    Name of cocktail. This parameter supports partial matches (e.g. bloody will match bloody mary and bloody margarita).

  • ingredients  optional

    Comma-separated string of ingredients to search. Only cocktails containing all listed ingredients will be returned. For example, to search cocktails containing Vodka and lemon juice, use vodka,lemon juice.

Headers

  • X-Api-Key  required

    API Key associated with your account.

Response

Returns an array of cocktail objects, each containing:

  • name

    Name of the cocktail.

  • ingredients

    Array of ingredient strings with measurements.

  • instructions

    Instructions for preparing the cocktail.

Sample Request Live Demo!

name

Try this API endpoint with all available parameters in our API playground

https://api.api-ninjas.com/v1/cocktail?name=bloody mary

Headers

X-Api-KeyLog in or sign up to get your API Key

Sample Response

JSON
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 [ { "name": "Bloody Mary", "ingredients": [ "4.5 cl (3 parts) vodka", "9 cl (6 parts) Tomato juice", "1.5 cl (1 part) Lemon juice", "2 to 3 dashes of Worcestershire Sauce", "Tabasco sauce", "Celery salt", "Black pepper" ], "instructions": "Stirring gently, pour all ingredients into highball glass. Garnish." } ]

Code Examples

1 2 curl -X GET "https://api.api-ninjas.com/v1/cocktail?name=bloody%20mary" \ -H "X-Api-Key: YOUR_API_KEY"

If your programming language is not listed in the Code Example above, you can still make API calls by using a HTTP request library written in your programming language and following the above documentation.