Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/thecocktaildb-lookup-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: TheCocktailDB Filter Lookup API
description: An open, crowd-sourced database of cocktails and drinks from around the world with a free API. Search cocktails by name, ingredient, category, glass type, or alcoholic content. Includes detailed recipes, measurements, and images.
version: '1.0'
contact:
url: https://www.thecocktaildb.com/
x-generated-from: documentation
servers:
- url: https://www.thecocktaildb.com/api/json/v1/1
description: Production API server (free tier with API key 1)
security: []
tags:
- name: Lookup
description: Retrieve details by ID
paths:
/lookup.php:
get:
operationId: lookupById
summary: TheCocktailDB Lookup Cocktail or Ingredient by ID
description: Look up a full cocktail detail by its ID using the 'i' parameter, or look up an ingredient by its ingredient ID using the 'iid' parameter.
tags:
- Lookup
parameters:
- name: i
in: query
description: Cocktail ID to look up
required: false
schema:
type: string
example: '11007'
- name: iid
in: query
description: Ingredient ID to look up
required: false
schema:
type: string
example: '552'
responses:
'200':
description: Cocktail or ingredient details
content:
application/json:
schema:
$ref: '#/components/schemas/CocktailsResponse'
examples:
LookupById200Example:
summary: Default lookupById 200 response
x-microcks-default: true
value:
drinks:
- idDrink: '11007'
strDrink: Margarita
strCategory: Ordinary Drink
strAlcoholic: Alcoholic
strGlass: Cocktail glass
strInstructions: Shake all ingredients together with ice.
strDrinkThumb: https://www.thecocktaildb.com/images/media/drink/5noda61589575158.jpg
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
/random.php:
get:
operationId: getRandomCocktail
summary: TheCocktailDB Get a Random Cocktail
description: Retrieve a single random cocktail with full details.
tags:
- Lookup
responses:
'200':
description: A random cocktail
content:
application/json:
schema:
$ref: '#/components/schemas/CocktailsResponse'
examples:
GetRandomCocktail200Example:
summary: Default getRandomCocktail 200 response
x-microcks-default: true
value:
drinks:
- idDrink: '15346'
strDrink: Aviation
strCategory: Cocktail
strAlcoholic: Alcoholic
strGlass: Cocktail glass
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
components:
schemas:
Drink:
type: object
description: Full cocktail details including ingredients, instructions, and media
properties:
idDrink:
type: string
description: Unique cocktail identifier
example: '11007'
strDrink:
type: string
description: Cocktail name
example: Margarita
strDrinkAlternate:
type:
- string
- 'null'
description: Alternate name for the cocktail
strTags:
type:
- string
- 'null'
description: Comma-separated tags
strVideo:
type:
- string
- 'null'
description: Video URL
strCategory:
type: string
description: Category of drink
example: Ordinary Drink
strIBA:
type:
- string
- 'null'
description: IBA classification
strAlcoholic:
type: string
description: Whether the drink is alcoholic
enum:
- Alcoholic
- Non alcoholic
- Optional alcohol
example: Alcoholic
strGlass:
type: string
description: Type of glass
example: Cocktail glass
strInstructions:
type: string
description: Preparation instructions in English
strInstructionsES:
type:
- string
- 'null'
description: Preparation instructions in Spanish
strInstructionsDE:
type:
- string
- 'null'
description: Preparation instructions in German
strInstructionsFR:
type:
- string
- 'null'
description: Preparation instructions in French
strInstructionsIT:
type:
- string
- 'null'
description: Preparation instructions in Italian
strDrinkThumb:
type: string
description: Thumbnail image URL
example: https://www.thecocktaildb.com/images/media/drink/5noda61589575158.jpg
strIngredient1:
type:
- string
- 'null'
description: First ingredient
strIngredient2:
type:
- string
- 'null'
description: Second ingredient
strIngredient3:
type:
- string
- 'null'
description: Third ingredient
strMeasure1:
type:
- string
- 'null'
description: Measure for first ingredient
strMeasure2:
type:
- string
- 'null'
description: Measure for second ingredient
strMeasure3:
type:
- string
- 'null'
description: Measure for third ingredient
strImageSource:
type:
- string
- 'null'
description: Image source URL
strImageAttribution:
type:
- string
- 'null'
description: Image attribution
strCreativeCommonsConfirmed:
type:
- string
- 'null'
description: Whether image is Creative Commons confirmed
dateModified:
type:
- string
- 'null'
description: Date last modified
CocktailsResponse:
type: object
description: Response containing a list of cocktails
properties:
drinks:
type:
- array
- 'null'
description: Array of cocktail objects; null if no results found
items:
$ref: '#/components/schemas/Drink'