Search cocktails by name API

Search cocktails and full drink recipes by name via TheCocktailDB (keyless, free), with ingredients+measures normalized into clean arrays, instructions split into steps, glass, IBA, and alcoholic flag. Answers 'how to make a margarita', 'search cocktails called mojito', 'what's in a negroni', 'recipe for a martini'.

Price$0.01per request

MethodPOST

Route/v1/data/food-cocktail-search

StatusLive

MIME typeapplication/json

Rate limit60/minute

Cache3600s public

drinkcocktailrecipesearchbarthecocktaildbmixologyingredients

API URLhttps://x402.hexl.dev/v1/data/food-cocktail-search

Integration docs

Example request

{
  "query": "Margarita"
}

Example response

{
  "query": "Margarita",
  "count": 1,
  "drinks": [
    {
      "id": "11007",
      "name": "Margarita",
      "category": "Ordinary Drink",
      "iba": "Contemporary Classics",
      "alcoholic": "Alcoholic",
      "glass": "Cocktail glass",
      "ingredients": [
        {
          "name": "Tequila",
          "measure": "1 1/2 oz"
        },
        {
          "name": "Triple sec",
          "measure": "1/2 oz"
        },
        {
          "name": "Lime juice",
          "measure": "1 oz"
        },
        {
          "name": "Salt",
          "measure": null
        }
      ],
      "instructions": "Rub the rim of the glass with the lime slice...",
      "steps": [
        "Rub the rim of the glass with the lime slice",
        "Shake the other ingredients with ice"
      ],
      "tags": [
        "IBA",
        "ContemporaryClassic"
      ],
      "thumbnail": "https://www.thecocktaildb.com/images/media/drink/5noda61589575158.jpg"
    }
  ]
}

Input schema

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "examples": [
        "Margarita",
        "Mojito"
      ]
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}