NewAPIVerve Academy: free courses and certifications anyone can verify.Explore the Academy →

Cocktail Recipe API

GET

Match cocktail names or spirits to exact recipes and glassware.

Cocktail Recipe retrieves cocktail recipes by drink name or ingredient, providing measured ingredients, preparation instructions, and recommended glassware. Responses include serving categories and ingredient counts, with support for pulling random drinks.

Try it — live request, no key required

Request
GETapi.apiverve.com/v1/cocktail?name=martini
Query parameters
Verification
Format

No key required to try it. Get a key to use it in your app.

Example
{
  "status": "ok",
  "error": null,
  "data": {
    "count": 5,
    "filteredOn": "name",
    "cocktails": [
      {
        "name": "Espresso Martini",
        "glass": "martini",
        "category": "After Dinner Cocktail",
        "ingredients": [
          {
            "unit": "cl",
            "amount": 5,
            "ingredient": "Vodka"
          },
          {
            "unit": "cl",
            "amount": 1,
            "ingredient": "Coffee liqueur",
            "label": "Kahlúa"
          },
          {
            "special": "Sugar syrup (according to individual preference of sweetness)"
          },
          {
            "special": "1 short strong Espresso"
          }
        ],
        "ingredientCount": 4,
        "estimatedStrength": "medium",
        "preparation": "Shake and strain into a chilled cocktail glass."
      },
      {
        "name": "Lemon Drop Martini",
        "glass": "martini",
        "category": "All Day Cocktail",
        "ingredients": [
          {
            "unit": "cl",
            "amount": 2.5,
            "ingredient": "Vodka",
            "label": "Citron Vodka"
          },
          {
            "unit": "cl",
            "amount": 2,
            "ingredient": "Triple Sec"
          },
          {
            "unit": "cl",
            "amount": 1.5,
            "ingredient": "Lemon juice"
          }
        ],
        "garnish": "Lemon slice",
        "preparation": "Shake and strain into a chilled cocktail glass rimmed with sugar."
      },
      {
        "name": "French Martini",
        "glass": "martini",
        "category": "Before Dinner Cocktail",
        "ingredients": [
          {
            "unit": "cl",
            "amount": 4.5,
            "ingredient": "Vodka"
          },
          {
            "unit": "cl",
            "amount": 1.5,
            "ingredient": "Raspberry liqueur"
          },
          {
            "unit": "cl",
            "amount": 1.5,
            "ingredient": "Pineapple juice"
          }
        ],
        "preparation": "Stir in mixing glass with ice cubes. Strain into chilled cocktail glass. Squeeze oil from lemon peel onto the drink."
      },
      {
        "name": "Dirty Martini",
        "glass": "martini",
        "category": "Before Dinner Cocktail",
        "ingredients": [
          {
            "unit": "cl",
            "amount": 6,
            "ingredient": "Vodka"
          },
          {
            "unit": "cl",
            "amount": 1,
            "ingredient": "Vermouth",
            "label": "Dry vermouth"
          },
          {
            "unit": "cl",
            "amount": 1,
            "ingredient": "Olive juice"
          }
        ],
        "garnish": "Green olive",
        "preparation": "Stir in mixing glass with ice cubes. Strain into chilled martini glass."
      },
      {
        "name": "Dry Martini",
        "glass": "martini",
        "category": "Before Dinner Cocktail",
        "ingredients": [
          {
            "unit": "cl",
            "amount": 6,
            "ingredient": "Gin"
          },
          {
            "unit": "cl",
            "amount": 1,
            "ingredient": "Vermouth",
            "label": "Dry vermouth"
          }
        ],
        "preparation": "Stir in mixing glass with ice cubes. Strain into chilled martini glass. Squeeze oil from lemon peel onto the drink, or garnish with olive."
      }
    ]
  }
}

Start from a template — a working app you can deploy in a minute

About the Cocktail Recipe API

A cocktail recipe API for looking up drinks by name, finding cocktails by ingredient, or pulling a random drink. Each match comes back in a structured format: the glass, the category such as before-dinner or after-dinner, every ingredient with its amount and unit, the garnish where there is one, and short preparation steps.

It suits bar and restaurant apps, home bartending and mixology tools, party planners, smart-speaker skills and recipe sites. Search "martini" to get every martini variation in the collection, search "gin" to see what you can make from one bottle, or use the random option for a drink-of-the-day feature.

The Free plan returns the full recipe for every match, including measurements, glassware, garnish, preparation and an ingredient count. Paid plans add an estimated strength for each cocktail, labelled strong, medium, light or mocktail, so you can filter a menu by how boozy a drink is without working it out from the ingredient list yourself.

How it works

Cocktail Recipe searches a stored collection of cocktail recipes. name is a case-insensitive substring match on the drink's name, so martini returns the Espresso Martini, French Martini and every other name containing the word. ingredient is a whole-word, case-insensitive match against each ingredient's name and its more specific label, so gin matches Gin but not Ginger Beer. When both are sent, name wins. random=true picks one drink at random and then searches by its name, so a random call can return more than one result when other names contain it.

Each result has name, glass, category, ingredients and preparation, plus garnish when the recipe has one. An ingredient normally carries unit (such as cl or dash), amount and ingredient, with an optional label naming a specific product such as Kahlua. Some ingredients have no fixed measure and instead come back as a single special text field, such as "1 short strong Espresso". count is the number of matches, and filteredOn says whether the search used name, ingredient or random. No match returns a 404.

ingredientCount counts every ingredient entry, special ones included. estimatedStrength is a rule of thumb. Spirits such as gin, vodka, rum, whiskey, tequila and brandy count in full; liqueurs and aperitifs such as vermouth, triple sec, Campari and Aperol count at half. Eight centilitres or more, or two or more spirits, is strong. Four or more, or one spirit, is medium. Only liqueurs is light, and none of either is mocktail. It does not use real ABV figures. On the Free plan estimatedStrength is removed.

What people use it for

Bar Inventory Matching
Match available spirits against the ingredient search to show bartenders which drinks they can prepare with current bar stock.
Digital Drink Menus
Hospitality venues display drink preparation instructions and specific glassware recommendations directly on contactless tablet menus for guests.
Drink of the Day
To drive customer engagement, lifestyle apps fetch a random cocktail recipe each morning to feature on their home screen.
Event Menu Planning
Catering planners look up cocktail categories and measured ingredients to calculate supply quantities needed for upcoming wedding receptions.

Ways to call it

One endpoint, many ways in — REST with JSON, XML, YAML and CSV, plus GraphQL and an MCP interface for AI agents.

JSON
Default REST response
XML
Markup format
YAML
Human-readable
CSV
Tabular export
Beta
GraphQL
Query language
New
MCP
For AI agents

Other ways to use Cocktail Recipe

Same data, same APIVerve account, same credit balance — one key works on all of them.

Questions.

Common questions about the Cocktail Recipe API.

Read the docs →
Can I look up drinks when a user only has one ingredient on hand?
Yes. Alongside looking up drinks by cocktail name, you can query by a single ingredient like gin or rum to return all matching recipes that use it.
What recipe details are returned for each drink?
Every cocktail result includes step-by-step preparation steps, traditional glassware, cocktail category, and an ingredient count. Each ingredient is listed with its name, quantity, and unit of measure, such as cl or dash.
Is estimated drink strength included on the Free plan?
No. The estimated alcohol strength rating—indicating whether a drink is strong, medium, light, or a mocktail—is a premium field. Any paid plan unlocks this field across all recipe queries.
Is it cheap enough to fetch recipes for every drink search?
Yes. Each search costs 2 credits, meaning the Starter plan provides 100,000 recipe lookups every month. That works out to about $0.0003 per lookup, or $0.30 per 1,000 calls. The Free plan includes 100 calls per month to test your integration.
Can I pull a random cocktail recipe for daily drink features?
Yes. The API includes a dedicated endpoint that returns a random cocktail recipe with complete instructions and ingredients, making it straightforward to generate drink-of-the-day features.
Can I use recipe data in a commercial bartending or menu app?
Yes, provided you are on an active paid plan. Commercial use requires a Starter plan or higher. You may display the recipe details within your own product, but you cannot resell or redistribute the raw recipe dataset.

Ready to build with Cocktail Recipe? Start with 200 free credits — one key unlocks all 300+ APIs.

Explore the catalog

300+ APIs on the same key and the same response shape.

Browse all APIs