Public APIs
TheCocktailDB favicon

TheCocktailDB

Food & Drink

Cocktail Recipes.

TheCocktailDB's website screenshot

About TheCocktailDB

TheCocktailDB is a JSON API providing data on cocktails and drink ingredients, including search by name, listing by first letter, ingredient lookup, full cocktail detail lookup by ID, and a random cocktail endpoint. It supports filtering by ingredient, alcoholic content, category, and glass type, and provides list endpoints for categories, glasses, ingredients, and alcoholic filters. Drink and ingredient thumbnail images are available in multiple sizes via direct image URLs.

The API is free to use at its basic level using a shared test API key. A paid Premium tier is available for a one-off fee, adding multi-ingredient filtering, popular and recent cocktail lookups, a random-selection endpoint returning 10 drinks at once, access to the full database beyond a 100-item limit, and latest/random image API methods; a production API key is required for public app store releases.

The site also publishes machine-readable resources for AI agents and developers, including an agent guide, a reusable skill file, and OpenAPI V1 and V2 specifications for the JSON endpoints.

Key features

  • Search cocktails by name or first letter
  • Look up full cocktail details or ingredient details by ID
  • Filter cocktails by ingredient, alcoholic content, category, or glass
  • Retrieve random cocktail(s) and drink or ingredient thumbnail images
  • List all available categories, glasses, ingredients, or alcoholic filters

Frequently asked questions

Is TheCocktailDB free to use?

The API and site remain free to access at a basic level, and a test API key ("1") is available for development or educational use. A production API key requires a one-off $10 Premium API fee for public app store releases.

What extra features does the Premium API unlock?

Premium subscribers get multi-ingredient filtering, popular and recent cocktail lookups, the full database instead of a 100-item limit, and access to the latest and random image API methods.

What format does the API return data in?

The API returns JSON data via endpoints such as search.php, lookup.php, filter.php, list.php, and random.php.

Are there developer resources for AI agents or integration specs?

The site provides an AI Agent Guide (/AGENTS.md), an AI Skill file (/SKILL.md), and OpenAPI V1 and V2 specifications for the JSON endpoints.

Advertise here

Featured products

  • SerpApi - Search API favicon
  • Screenshot Scout favicon
  • TalorData favicon
  • CoreClaw favicon

Show your product to thousands of developers

· 100k monthly pageviews
· 7k newsletter subscribers

Advertise your product