TheCocktailDB

Overview

TheCocktailDB provides cocktail recipes — search, filter, and random drinks. The free test key 1 works for JSON API calls (verified live).

Quick Start

Search (the test key 1 is fine for the free tier):

curl "https://www.thecocktaildb.com/api/json/v1/1/search.php?s=margarita"

{
  "drinks": [
    {
      "idDrink": "11007",
      "strDrink": "Margarita",
      "strCategory": "Ordinary Drink",
      "strGlass": "Cocktail glass",
      "strInstructions": "Rub the rim of the glass with the lime slice...",
      "strDrinkThumb": "https://www.thecocktaildb.com/images/media/drink/5noda61589575158.jpg"
    }
  ]
}

Random / by ingredient:

curl "https://www.thecocktaildb.com/api/json/v1/1/random.php"
curl "https://www.thecocktaildb.com/api/json/v1/1/filter.php?i=gin"

Authentication

• The free/test API key is literally 1 (/api/json/v1/1/...) — no registration needed for basic use.
• Premium keys unlock more endpoints (patreon).

Rate Limits & Notes

• Free tier: limited requests/hour per the docs; be polite.
• Endpoints: search.php?s=, random.php, filter.php?i=, lookup.php?i=.

FAQ

Is TheCocktailDB free? The test key 1 works for JSON API calls (verified).

What’s the key? Use 1 for the free tier (verified).

Can I search by ingredient? Yes — filter.php?i=gin.