NewConnect Claude, Cursor, ChatGPT, and other AI agents to API Ninjas via our MCP server →

Cocktail API

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

(4.4)

From 7,417 users

2,400+

Applications using this API

API Status

Online - All Systems Operational

API Response Times

Average
P50
P75
P90
P95
217ms230ms307ms663ms1122ms

Similar APIs

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

A JSON array of objects, each containing the following fields, or an error if the request is unsuccessful.

  • 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

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.