List Cocktails by First Letter - mkasfeldt/TheCocktailDB-Docs GitHub Wiki

Description

The API call to list all cocktails with a the first letter of a cocktail name.

Format

API Call

Free Key API Call

https://www.thecocktaildb.com/api/json/v1/1/search.php?=f**First_Letter_Of_Cocktail_Name**

  • Replace First_Letter_Of_Cocktail_Name with the cocktail name (e.g. a)

https://www.thecocktaildb.com/api/json/v2/API_Key/search.php?=First_Letter_Of_Cocktail_Name

  • Replace API_Key with your API key
  • Replace First_Letter_Of_Cocktail_Name with the cocktail name (e.g. a)

JSON Return

Returns a JSON object of 'drinks' that contains an array of cocktails with key-pairs that provide information about it. The array will contain a maximum of 100 cocktails for the free API key.

JSON Return Format

A drinks object that contains an array of drinks with the following fields:

Key Name Value
idDrink (integer) The cocktail ID.
strDrink (string) The cocktail name.
strDrinkAlternate (string) The cocktail's alternate name or None if none exists.
strTags (string) A comma delimited string of the cocktail's classification(s).
strVideo (string) The URL of a video about the cocktail or None if none exists.
strCategory (string) a comma delimited string of the cocktail's categories.
strIBA (string) The International Bartenders Association classification of the cocktail or None if none exists.
strAlcoholic (string) Alcoholic if the cocktail contains alcohol or Non-Alcholic if the cocktail does not contain alcohol.
strGlass (string) The type of glass for the cocktail.
strInstructions (string) English instructions on how to make the cocktail or None if none exists.
strInstructionsES (string) Spanish instructions on how to make the cocktail or None if none exists.
strInstructionsDE (string) German instructions on how to make the cocktail or None if none exists.
strInstructionsFR (string) French instructions on how to make the cocktail or None if none exists.
strInstructionsIT (string) Italian instructions on how to make the cocktail or None if none exists.
strInstructionsZH-HANS (string) Simplified Chinese instructions on how to make the cocktail or None if none exists.
strInstructionsZH-HANT (string) Traditional instructions on how to make the cocktail or None if none exists.
strDrinkThumb (string) The 100px by 100px thumbnail image of the cocktail or None if none exists.
strIngredient1 to 15 (string) Up to 15 ingredients can be used to make a drink. The first ingredient key name is strIngredient1 and the fifteenth is strIngredient15. Each field will contain an ingredient that is contained in the database or None if none exists. The list of ingredients can be found by using the List All Ingredients API call (Note: this API call will only return 100 results unless you are using the subscriber version of the API call).
strMeasure1 to 15 (string) Up to 15 measurements that correspond to the ingredients can be used to make a drink. The first measure key name is strMeasure1 and the fifteenth is strMeasure15. Each field will contain the measurement for the corresponding ingredient or None if none exists.
strImageSource (string) The URL of the cocktail's image or None if none exists.
strImageAttribution (string) The name of the person who contributed the image or None if none exists.
strCreativeCommonsConfirmed (string) Yes if the image is part of Creative Commons or No if it is not.
dateModified (date) The date the image has been modified or None if none exists.

Example

API Call Example

https://www.thecocktaildb.com/api/json/v1/1/search.php?f=a

JSON Response Example

{"drinks":[{"idDrink":"17222","strDrink":"A1","strDrinkAlternate":null,"strTags":null,"strVideo":null,"strCategory":"Cocktail","strIBA":null,"strAlcoholic":"Alcoholic","strGlass":"Cocktail glass","strInstructions":"Pour all ingredients into a cocktail shaker, mix and serve over ice into a chilled glass.","strInstructionsES":"Vierta todos los ingredientes en una coctelera, mezcle y sirva con hielo en un vaso fr\u00edo.","strInstructionsDE":"Alle Zutaten in einen Cocktailshaker geben, mischen und \u00fcber Eis in ein gek\u00fchltes Glas servieren.","strInstructionsFR":null,"strInstructionsIT":"Versare tutti gli ingredienti in uno shaker, mescolare e servire con ghiaccio in un bicchiere freddo.","strInstructionsZH-HANS":null,"strInstructionsZH-HANT":null,"strDrinkThumb":"https:\/\/www.thecocktaildb.com\/images\/media\/drink\/2x8thr1504816928.jpg","strIngredient1":"Gin","strIngredient2":"Grand Marnier","strIngredient3":"Lemon Juice","strIngredient4":"Grenadine","strIngredient5":null,"strIngredient6":null,"strIngredient7":null,"strIngredient8":null,"strIngredient9":null,"strIngredient10":null,"strIngredient11":null,"strIngredient12":null,"strIngredient13":null,"strIngredient14":null,"strIngredient15":null,"strMeasure1":"1 3\/4 shot ","strMeasure2":"1 Shot ","strMeasure3":"1\/4 Shot","strMeasure4":"1\/8 Shot","strMeasure5":null,"strMeasure6":null,"strMeasure7":null,"strMeasure8":null,"strMeasure9":null,"strMeasure10":null,"strMeasure11":null,"strMeasure12":null,"strMeasure13":null,"strMeasure14":null,"strMeasure15":null,"strImageSource":null,"strImageAttribution":null,"strCreativeCommonsConfirmed":"No","dateModified":"2017-09-07 21:42:09"},{"idDrink":"13501","strDrink":"ABC","strDrinkAlternate":null,"strTags":null,"strVideo":null,"strCategory":"Shot","strIBA":null,"strAlcoholic":"Alcoholic","strGlass":"Shot glass","strInstructions":"Layered in a shot glass.","strInstructionsES":"Coloque todos los ingredientes en un vaso de chupito.","strInstructionsDE":"Schichtaufbau in einem Schnapsglas.","strInstructionsFR":null,"strInstructionsIT":"Versa in ordine di lettera i vari ingredienti. 1\/3 del bicchiere va riempito con l'Amaretto, 1\/3 di Baileys e il restante di Cognac.","strInstructionsZH-HANS":null,"strInstructionsZH-HANT":null,"strDrinkThumb":"https:\/\/www.thecocktaildb.com\/images\/media\/drink\/tqpvqp1472668328.jpg","strIngredient1":"Amaretto","strIngredient2":"Baileys irish cream","strIngredient3":"Cognac","strIngredient4":null,"strIngredient5":null,"strIngredient6":null,"strIngredient7":null,"strIngredient8":null,"strIngredient9":null,"strIngredient10":null,"strIngredient11":null,"strIngredient12":null,"strIngredient13":null,"strIngredient14":null,"strIngredient15":null,"strMeasure1":"1\/3 ","strMeasure2":"1\/3 ","strMeasure3":"1\/3 ","strMeasure4":null,"strMeasure5":null,"strMeasure6":null,"strMeasure7":null,"strMeasure8":null,"strMeasure9":null,"strMeasure10":null,"strMeasure11":null,"strMeasure12":null,"strMeasure13":null,"strMeasure14":null,"strMeasure15":null,"strImageSource":null,"strImageAttribution":null,"strCreativeCommonsConfirmed":"No","dateModified":"2016-08-31 19:32:08"}, ...]}

⚠️ **GitHub.com Fallback** ⚠️