TheCocktailAPI: A RESTful API for Cocktail Recipes

Find IBA official cocktail recipes and recipes contributed on TheCocktailApp. This is mostly a consumption-only API — only the HTTP GET method is available here. If you want to add your recipe, you're welcome to do so via TheCocktailApp.

Note that this API is no longer hosted. The data you see is coming from JSON files. You can read more about it on the API's about page.

API endpoints

Below are described the REST endpoints available that you can use to search for recipes. No authentication is required to access this API, and all resources are fully open and available.

• List of All Recipes

  Get a list of all recipes available: /recipes

  Name	Description	Type
  id	The recipe identifier.	integer
  name	The recipe name.	string
  image	The link to the recipe image. If a contributed recipe does not have an image, there is a placeholder image from Unsplash.	string
  ingredients	A comma-separated list of ingredients.	string

• List of IBA Cocktails

  Get a list of IBA Cocktail recipes only: /recipes/iba

  Name	Description	Type
  id	The recipe identifier.	integer
  name	The recipe name.	string
  image	The link to the recipe image.	string
  ingredients	A comma-separated list of ingredients.	string

• Recipe by id

  Search recipe by id: /recipes/{id}

  Name	Description	Type
  id	The recipe identifier.	integer
  name	The recipe name.	string
  image	An object containing the image details	object
  image.url	The link to the recipe image.	string
  image.source	The link to the image source, e.g.: unsplash.com.	string
  image.author	The image author's name.	string
  image.license	The license under which the image is distributed.	string
  recipeCategory	The IBA cocktails category (The unforgettables, Contemporary classics, New era drinks) or "other cocktails".	string
  description	A brief description of the recipe.	string
  recipeIngredient	And array of objects containing ingredient details.	list
  recipeIngredient.id	The ingredient identifier within this ingredient list.	integer
  recipeIngredient.ingredient	The ingredient name.	string
  recipeIngredient.quantity	The quantity and unit of measurement.	string
  recipeGarnish	A comma-seperated list of garnish.	string
  recipeInstructions	And array of objects containing instruction details.	list
  recipeInstructions.id	The instruction identifier.	integer
  recipeInstructions.step	The description of what to do.	string