{"openapi":"3.1.0","info":{"title":"Cocktails API","version":"1.0.0","description":"Search cocktails, fetch full recipes with measured ingredients and instructions, get a random drink, and filter by ingredient, category, glass or alcoholic / non-alcoholic. Each cocktail includes a photo and tags. Powered by TheCocktailDB.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/cocktails-api","description":"oanor gateway"}],"tags":[{"name":"Cocktails"},{"name":"Discovery"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/lookup":{"get":{"operationId":"get_v1_lookup","tags":["Cocktails"],"summary":"Full cocktail by id","description":"","parameters":[{"name":"id","in":"query","required":true,"description":"Numeric drink id","schema":{"type":"string"},"example":"11007"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"id":"11007","name":"Margarita","tags":["IBA","ContemporaryClassic"],"glass":"Cocktail glass","category":"Ordinary Drink","alcoholic":"Alcoholic","thumbnail":"https://www.thecocktaildb.com/images/media/drink/5noda61589575158.jpg","ingredients":[{"measure":"1 1/2 oz","ingredient":"Tequila"},{"measure":"1/2 oz","ingredient":"Triple sec"},{"measure":"1 oz","ingredient":"Lime juice"},{"ingredient":"Salt"}],"instructions":"Rub the rim of the glass with the lime slice to make the salt stick to it. Take care to moisten only the outer rim and sprinkle the salt on it. The salt should present to the lips of the imbiber and never mix into the cocktail. Shake the other ingredients with ice, then carefully pour into the glass."},"meta":{"timestamp":"2026-05-30T02:58:48.498Z","request_id":"b1583981-8853-46e2-8845-7f7ab01b9214"},"status":"ok","message":"Cocktail retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/random":{"get":{"operationId":"get_v1_random","tags":["Cocktails"],"summary":"A random cocktail","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"id":"178339","name":"The Strange Weaver","tags":["Classy"],"glass":"Collins glass","category":"Cocktail","alcoholic":"Alcoholic","thumbnail":"https://www.thecocktaildb.com/images/media/drink/opxjzh1604179528.jpg","ingredients":[{"measure":"1 oz","ingredient":"Light Rum"},{"measure":"1 oz","ingredient":"Gin"},{"measure":"0.75 oz","ingredient":"Sweet Vermouth"},{"measure":"0.75 oz","ingredient":"Campari"},{"measure":"Dash","ingredient":"Lemon Juice"},{"measure":"Dash","ingredient":"Orgeat Syrup"},{"measure":"Garnish with","ingredient":"Orange Peel"}],"instructions":"Mix ingredients slowly in a glass with ice, garnish with orange slice"},"meta":{"timestamp":"2026-05-30T02:58:49.704Z","request_id":"8d1f3aa9-ba3c-45f2-82c5-f61d132d589a"},"status":"ok","message":"Random cocktail retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/search":{"get":{"operationId":"get_v1_search","tags":["Cocktails"],"summary":"Search cocktails by name","description":"","parameters":[{"name":"q","in":"query","required":true,"description":"Cocktail name","schema":{"type":"string"},"example":"margarita"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":6,"query":"margarita","cocktails":[{"id":"11007","name":"Margarita","tags":["IBA","ContemporaryClassic"],"glass":"Cocktail glass","category":"Ordinary Drink","alcoholic":"Alcoholic","thumbnail":"https://www.thecocktaildb.com/images/media/drink/5noda61589575158.jpg","ingredients":[{"measure":"1 1/2 oz","ingredient":"Tequila"},{"measure":"1/2 oz","ingredient":"Triple sec"},{"measure":"1 oz","ingredient":"Lime juice"},{"ingredient":"Salt"}],"instructions":"Rub the rim of the glass with the lime slice to make the salt stick to it. Take care to moisten only the outer rim and sprinkle the salt on it. The salt should present to the lips of the imbiber and never mix into the cocktail. Shake the other ingredients with ice, then carefully pour into the glass."},{"id":"11118","name":"Blue Margarita","tags":[],"glass":"Cocktail glass","category":"Ordinary Drink","alcoholic":"Alcoholic","thumbnail":"https://www.thecocktaildb.com/images/media/drink/bry4qh1582751040.jpg","ingredients":[{"measure":"1 1/2 oz","ingredient":"Tequila"},{"measure":"1 oz","ingredient":"Blue Curacao"},{"measure":"1 oz","ingredient":"Lime juice"},{"measure":"Coarse","ingredient":"Salt"}],"instructions":"Rub rim of cocktail glass with lime juice. Dip rim in coarse salt. Shake tequila, blue curacao, and lime juice with ice, strain into the salt-rimmed glass, and serve."},{"id":"17216","name":"Tommy's Margarita","tags":["IBA","NewEra"],"glass":"Old-Fashioned glass","category":"Ordinary Drink","alcoholic":"Alcoholic","thumbnail":"https://www.thecocktaildb.com/images/media/drink/loezxn1504373874.jpg","ingredients":[{"measure":"4.5 cl","ingredient":"Tequila"},{"measure":"1.5 cl","ingredient":"Lime Juice"},{"measure":"2 spoons","ingredient":"Agave syrup"}],"instructions":"Shake and strain into a chilled cocktail glass."},{"id":"16158","name":"Whitecap Margarita","tags":[],"glass":"Margarita/Coupette glass","category":"Other / Unknown","alcoholic":"Alcoholic","thumbnail":"https://www.thecocktaildb.com/images/media/drink/srpxxp1441209622.jpg","ingredients":[{"measure":"1 cup","ingredient":"Ice"},{"measure":"2 oz","ingredient":"Tequila"},{"measure":"1/4 cup","ingredient":"Cream of coconut"},{"measure":"3 tblsp fresh","ingredient":"Lime juice"}],"instructions":"Place all ingredients in a blender and blend until smooth. This makes one drink."},{"id":"12322","name":"Strawberry Margarita","tags":[],"glass":"Cocktail glass","category":"Ordinary Drink","alcoholic":"Alcoholic","thumbnail":"https://www.thecocktaildb.com/images/media/drink/tqyrpw1439905311.jpg","ingredients":[{"measure":"1/2 oz","ingredient":"Strawberry schnapps"},{"measure":"1 oz","ingredient":"Tequila"},{"measure":"1/2 oz","ingredient":"Triple sec"},{"measure":"1 oz","ingredient":"Lemon juice"},{"measure":"1 oz","ingredient":"Strawberries"},{"ingredient":"Salt"}],"instructions":"Rub rim of cocktail glass with lemon juice and dip rim in salt. Shake schnapps, tequila, triple sec, lemon juice, and strawberries with ice, strain into the salt-rimmed glass, and serve."},{"id":"178332","name":"Smashed Watermelon Margarita","tags":[],"glass":"Collins glass","category":"Cocktail","alcoholic":"Alcoholic","thumbnail":"https://www.thecocktaildb.com/images/media/drink/dztcv51598717861.jpg","ingredients":[{"measure":"1/2 cup","ingredient":"Watermelon"},{"measure":"5","ingredient":"Mint"},{"measure":"1/3 Cup","ingredient":"Grapefruit Juice"},{"measure":"Juice of 1/2","ingredient":"Lime"},{"measure":"1 shot","ingredient":"Tequila"},{"measure":"Garnish with","ingredient":"Watermelon"},{"measure":"Garnish with","ingredient":"Mint"}],"instructions":"In a mason jar muddle the watermelon and 5 mint leaves together into a puree and strain. Next add the grapefruit juice, juice of half a lime and the tequila as well as some ice. Put a lid on the jar and shake. Pour into a glass and add more ice. Garnish with fresh mint and a small slice of watermelon."}]},"meta":{"timestamp":"2026-05-30T02:58:50.091Z","request_id":"02843537-a03f-426d-a95b-2b663fe3041f"},"status":"ok","message":"Cocktails retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/filter":{"get":{"operationId":"get_v1_filter","tags":["Discovery"],"summary":"Filter by ingredient/category/glass/alcoholic","description":"","parameters":[{"name":"ingredient","in":"query","required":false,"description":"Main ingredient","schema":{"type":"string"},"example":"Gin"},{"name":"category","in":"query","required":false,"description":"Category","schema":{"type":"string"},"example":"Cocktail"},{"name":"glass","in":"query","required":false,"description":"Glass type","schema":{"type":"string"},"example":"Highball glass"},{"name":"alcoholic","in":"query","required":false,"description":"Alcoholic / Non_Alcoholic","schema":{"type":"string"},"example":"Alcoholic"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":1,"filter":{"type":"ingredient","value":"Gin"},"cocktails":[{"id":"15300","name":"3-Mile Long Island Iced Tea","thumbnail":"https://www.thecocktaildb.com/images/media/drink/rrtssw1472668972.jpg"}]},"meta":{"timestamp":"2026-05-30T02:58:50.473Z","request_id":"1da25e97-a014-423f-b9b7-f824ae702fbf"},"status":"ok","message":"Filtered cocktails retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/list":{"get":{"operationId":"get_v1_list","tags":["Discovery"],"summary":"List filter values","description":"","parameters":[{"name":"type","in":"query","required":true,"description":"categories | glasses | ingredients | alcoholic","schema":{"type":"string"},"example":"glasses"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"type":"glasses","count":32,"values":["Balloon Glass","Beer Glass","Beer mug","Beer pilsner","Brandy snifter","Champagne flute","Cocktail glass","Coffee mug","Collins glass","Copper Mug","Cordial glass","Coupe Glass","Highball glass","Hurricane glass","Irish coffee cup","Jar","Margarita glass","Margarita/Coupette glass","Martini Glass","Mason jar","Nick and Nora Glass","Old-fashioned glass","Parfait glass","Pint glass","Pitcher","Pousse cafe glass","Punch bowl","Shot glass","Whiskey Glass","Whiskey sour glass","White wine glass","Wine Glass"]},"meta":{"timestamp":"2026-05-30T02:58:50.908Z","request_id":"d2652b91-bbda-4b92-a75b-473b654e697d"},"status":"ok","message":"List retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":2500,"rps_limit":2,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":600,"monthly_call_quota":40000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1800,"monthly_call_quota":200000,"rps_limit":25,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":4400,"monthly_call_quota":1200000,"rps_limit":80,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/cocktails-api"}