Developer Documentation
Complete cocktail recipe database and mixology reference. 636 cocktails with ABV, calories, and flavor profiles, 300+ ingredients, 25 techniques, 15 cocktail families, 11 categories, 14 glass types, 150+ guides, 100+ glossary terms, and interactive tools. All data sourced from CocktailFYI — the Beverage FYI Family encyclopedia at cocktailfyi.com.
- 636 cocktails with estimated ABV, calories, difficulty, and ingredient lists
- 300+ ingredients across 10 types: spirit, liqueur, wine, beer, mixer, juice, syrup, garnish, bitter, other
- 25 mixing techniques with tool requirements
- 15 cocktail families (Sour, Daisy, Fizz, Highball, etc.)
- 11 drink categories (Ordinary Drink, Cocktail, Shot, Punch, etc.)
- 14 glass types with usage guides
- 8 occasions (After Dinner, Beach, Brunch, Date Night, etc.)
- 150+ educational guides across multiple series
- 100+ glossary terms with definitions
- N² comparison pages: cocktail vs cocktail, ingredient pairs
- Nutrition data per cocktail (calories, ABV)
- Ingredient substitution suggestions
- 15 languages supported
Quick Start
curl -s "https://cocktailfyi.com/api/v1/cocktails/margarita/"
API Endpoints
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/v1/cocktails/ | List all cocktails (DRF, paginated) |
| GET | /api/v1/cocktails/{slug}/ | Cocktail detail |
| GET | /api/v1/ingredients/ | List all ingredients |
| GET | /api/v1/ingredients/{slug}/ | Ingredient detail |
| GET | /api/v1/categories/ | List all categories |
| GET | /api/v1/techniques/ | List all techniques |
| GET | /api/v1/glossary/ | List glossary terms |
| GET | /api/v1/guides/ | List guides |
| GET | /api/v1/faqs/ | List FAQs |
| GET | /api/v1/search/?q={query} | Unified search |
| GET | /api/v1/stats/ | Site statistics |
URL Patterns
Use these patterns to construct URLs programmatically:
/cocktail/{slug}/
Cocktail detail with recipe, ABV, calories (e.g. /cocktail/margarita/)
/nutrition/{slug}/
Cocktail nutrition details (e.g. /nutrition/margarita/)
/ingredient/{slug}/
Ingredient detail (e.g. /ingredient/vodka/)
/ingredients/
All ingredients (e.g. /ingredients/)
/substitute/{slug}/
Ingredient substitutes (e.g. /substitute/triple-sec/)
/spirit/{slug}/
Spirit detail (e.g. /spirit/tequila/)
/spirits/
All spirits (e.g. /spirits/)
/glass/{slug}/
Glass type detail (e.g. /glass/martini-glass/)
/glasses/
All glass types (e.g. /glasses/)
/category/{slug}/
Drink category (e.g. /category/ordinary-drink/)
/categories/
All categories (e.g. /categories/)
/occasion/{slug}/
Occasion cocktails (e.g. /occasion/brunch/)
/occasions/
All occasions (e.g. /occasions/)
/cocktails-with/{slug}/
Cocktails using an ingredient (e.g. /cocktails-with/vodka/)
/compare/{slug_a}-vs-{slug_b}/
Compare two cocktails (e.g. /compare/margarita-vs-daiquiri/)
/guide/
All guides (e.g. /guide/)
/guide/{slug}/
Guide detail (e.g. /guide/how-to-shake/)
/glossary/
All glossary terms (e.g. /glossary/)
/glossary/{slug}/
Glossary term detail (e.g. /glossary/muddling/)
/tools/
Interactive tools (e.g. /tools/)
/tools/{slug}/
Tool page (e.g. /tools/abv-calculator/)
/search/
Search cocktails, ingredients, guides (e.g. /search/?q=mojito)
/developers/
API documentation (e.g. /developers/)
/api/openapi.json
OpenAPI 3.0 spec (NOT /api/v1/openapi.json) (e.g. /api/openapi.json)
/api/openapi.json
DRF Spectacular schema (alternative) (e.g. /api/openapi.json)
Response Format
All endpoints return JSON with pagination:
Example JSON response
{
"count": 636,
"next": "https://example.com/api/v1/items/?page=2",
"previous": null,
"results": [
{"slug": "example", "name": "Example Item", "...": "..."}
]
}
OpenAPI Specification
Full API schema available as OpenAPI 3.1.0 JSON. Import into Swagger UI, Postman, or any OpenAPI-compatible tool.
SDK Packages
PyPI
pip install cocktailfyi
Cocktail ABV, calories, flavor profiles
Embed Widget
Embed data cards on your site:
https://widget.cocktailfyi.com
npm install cocktailfyi-embed
Format Support
- Markdown endpoints: Append
.mdto any page URL for LLM-friendly markdown output. - Internationalization: Content available in 14 languages: ko, ja, zh-hans, es, fr, de, pt, ru, vi, tr, ar, hi, th, id.