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
167ms187ms263ms601ms1112ms

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.

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 [ { "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.", "name": "bloody mary" } ]

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.