Name: Search Drinks API 🍷: Find the right Beverages for your Preferences 🍒
Brand: skycraft
SKU: api-skycraft-search-drinks
Availability: InStock
Author: API Market

Pulkit

# Search Drinks API 🍷

### Overview

Search for drinks by title, ingredients, flavor, type of glass, alcohol content, and more. This endpoint lets you combine multiple filters – such as specific flavors, diets, and nutrient constraints – to find perfectly matched drinks.

💼 **Provider**: API League 

---

## Features
✅ **Comprehensive Filtering :** 
 Refine results by selecting ingredients, dietary preferences, flavor profiles, and nutritional values. 
✅ **Alcohol Content :** 
Specify a minimum or maximum alcohol percentage to adjust the strength of the drink. 
✅ **Sorting & Pagination :** 
 Sort results by calorie count or other criteria, and paginate them to retrieve in manageable batches.


---

## Use Cases
🔹**Bar & Mixology Apps** 
Quickly locate cocktails or mocktails matching user preferences. 
🔹**Health & Diet Tracking** 
Filter drinks that align with certain nutritional or diet constraints. 
🔹**Party Planning** 
Find beverages in a specific alcohol range or with particular taste profiles. 


---

## API Reference

#### 1. Search Drinks
🔹**Query Parameters**:
| Parameter | Type | Example | Description |
|--------------------------|------------------|--------------------------|-----------------------------------------------------------------------------------------------------------------|
| **query** | string | vodka | The search query. |
| **glass-types** | string | Highball Glass | A comma-separated list (interpreted as OR) of glass types that the drink should be served in. |
| **flavors** | string | sour,sweet | A comma-separated list (interpreted as AND) of dominant flavors in the drink. |
| **diet** | string | paleo | The diet the drink must adhere to. One of the following: paleo, primal, grain-free, vegan, vegetarian. |
| **include-ingredients** | string | orange | A comma-separated list of ingredients that should/must be used in the drinks. |
| **exclude-ingredients** | string | vodka | A comma-separated list of ingredients or ingredient types that the drinks must not contain. |
| **min-calories** | number($double) | 100 | The minimum amount of calories the drink must have per serving. |
| **max-calories** | number($double) | 655 | The maximum amount of calories the drink can have per serving. |
| **min-carbs** | number($double) | 10.1 | The minimum amount of carbohydrates in grams the drink must have per serving. |
| **max-carbs** | number($double) | 25.5 | The maximum amount of carbohydrates in grams the drink can have per serving. |
| **min-protein** | number($double) | 10.1 | The minimum amount of protein in grams the drink must have per serving. |
| **max-protein** | number($double) | 25.5 | The maximum amount of protein in grams the drink can have per serving. |
| **min-fat** | number($double) | 10.1 | The minimum amount of fat in grams the drink must have per serving. |
| **max-fat** | number($double) | 25.5 | The maximum amount of fat in grams the drink can have per serving. |
| **min-alcohol-percent** | number($double) | 10 | The minimum alcohol percentage the drink must have. |
| **max-alcohol-percent** | number($double) | 35 | The maximum alcohol percentage the drink can have. |
| **min-caffeine** | number($double) | 30.4 | The minimum amount of caffeine in milligrams the drink must have per serving. |
| **max-caffeine** | number($double) | 80.9 | The maximum amount of caffeine in milligrams the drink can have per serving. |
| **sort** | string | calories | The attribute by which to sort the drinks. |
| **sort-direction** | string | ASC | Whether to sort ascending or descending (ASC or DESC). |
| **offset** | integer($int32) | 0 | The number of drinks to skip, between 0 and 90. |
| **number** | integer($int32) | 3 | The number of drinks, between 1 and 10. |
| **x-api-market-key** | string | hsbdicavciya122334| API.market API Key. |

🔹**Example Request**:

 ```
curl -X 'GET' \
 'https://prod.api.market/api/v1/apileague/search-drinks/search-drinks?query=vodka&glass-types=Highball%20Glass&flavors=sour%2Csweet&diet=paleo&include-ingredients=orange&exclude-ingredients=vodka&min-calories=100&max-calories=655&min-carbs=10.1&max-carbs=25.5&min-protein=10.1&max-protein=25.5&min-fat=10.1&max-fat=25.5&min-alcohol-percent=10&max-alcohol-percent=35&min-caffeine=30.4&max-caffeine=80.9&sort=calories&sort-direction=ASC&offset=0&number=3' \
 -H 'accept: application/json' \
 -H 'x-api-market-key: <your_api_key>'
```

🔹**Response**:
 ```
{
 "offset": 0,
 "number": 1,
 "drinks": [
 {
 "flavors": [
 "creamy",
 "spicy",
 "sour",
 "sweet"
 ],
 "instructions": [
 {
 "name": "",
 "steps": [
 {
 "number": 1,
 "ingredients": [
 {
 "name": "nutmeg",
 "image": "https://img.spoonacular.com/ingredients_100x100/ground-nutmeg.jpg",
 "id": 2025
 }
 ],
 "equipment": [],
 "step": "Blend all ingredients, save nutmeg."
 },
 {
 "number": 2,
 "ingredients": [
 {
 "name": "white wine",
 "image": "https://img.spoonacular.com/ingredients_100x100/white-wine.jpg",
 "id": 14106
 },
 {
 "name": "nutmeg",
 "image": "https://img.spoonacular.com/ingredients_100x100/ground-nutmeg.jpg",
 "id": 2025
 }
 ],
 "equipment": [],
 "step": "Pour into large white wine glass and sprinkle nutmeg on top."
 }
 ]
 }
 ],
 "images": [
 "https://img.apileague.com/recipes/1957030-90x90.jpg",
 "https://img.apileague.com/recipes/1957030-312x231.jpg",
 "https://img.apileague.com/recipes/1957030-636x393.jpg",
 "https://img.apileague.com/recipes/1957030-556x370.jpg"
 ],
 "nutrition": {
 "weight_per_serving": {
 "amount": 228,
 "unit": "g"
 },
 "caloric_breakdown": {
 "percent_fat": 56.13,
 "percent_carbs": 37.36,
 "percent_protein": 6.51
 },
 "flavonoids": [...],
 "ingredient_breakdown": [...],
 "properties": [...],
 "nutrients": [...]
 },
 "glass_type": "wine glass",
 "credits": {
 "text": "drinkhero",
 "source_name": "thecocktaildb.com",
 "source_url": "https://www.thecocktaildb.com/drink/16967"
 },
 "price_per_serving": 195.84,
 "description": "The Vodka Fizz has a unique and intriguing taste profile...",
 "ingredients": [...],
 "id": 1957030,
 "title": "Vodka Fizz",
 "cuisines": []
 }
 ],
 "total_results": 14
}

```
---

## Best Practices 
✅ **Combine Filters :** Mix flavor preferences with dietary restrictions to find precise matches. 
✅ **Specify Alcohol Range :** Use `min-alcohol-percent` and `max-alcohol-percent` to control the drink's potency. 
✅ **Valid Query Input :** Ensure proper validation for numeric constraints like macros (carbs, fat, protein) and alcohol content. 
✅ **Pagination :** Use `offset` and `number` to paginate results for large data sets. 
✅ **Error Handling :** Appropriately manage 4xx/5xx errors (e.g., invalid queries or rate-limiting).


---

## SEO Keywords

🔹 
`drink search`, `cocktail finder`, `bar recipes`, `glass type filter`, `alcohol content`

🚀 Get Started Today! 

📩 Support Contact: [support@api.market](mailto\:support@api.market)

The Search Drinks API enables users to find cocktails, mocktails, and beverages based on ingredients, flavors, glass type, and alcohol content.