# CocktailBuilder

> Free cocktail generator: tell it which spirits and mixers you have, and it shows every cocktail you can make from your bar — 10,000+ recipes with exact ratios, user ratings, and substitution suggestions.

## Core pages

- [Cocktail builder tool](https://www.cocktailbuilder.com/): pick the ingredients you own, instantly see every drink you can mix, plus "almost there" recipes one bottle away
- [Recipe pages](https://www.cocktailbuilder.com/recipe/old-fashioned): `/recipe/<name>` — ingredient list with exact ratios, instructions, glassware, garnish, ratings, and FAQs
- [Ingredient pages](https://www.cocktailbuilder.com/ingredient/watermelon-604): `/ingredient/<name>-<id>` — every cocktail that uses an ingredient, with brand suggestions
- [Blog](https://blog.cocktailbuilder.com/): cocktail guides, ingredient explainers, seasonal roundups, and cocktail history

## API (free, no key, JSON)

- [OpenAPI spec](https://www.cocktailbuilder.com/openapi.json): machine-readable description of every endpoint below
- [What can I make?](https://www.cocktailbuilder.com/json/whatCanIMake?ingredients=vodka,lime%20juice,triple%20sec): `GET /json/whatCanIMake?ingredients=<comma-separated names>&max=30` — returns cocktails you can make from those ingredients (`complete: true`) and the ones a single bottle away (`ingredientsMissing: 1`), each with its recipe URL. This is the best way for an assistant to answer "what cocktail can I make with X, Y and Z".
- [Recipe details](https://www.cocktailbuilder.com/json/cocktailDetails?param=1): `GET /json/cocktailDetails?param=<cocktail id>` — ingredients with amounts, instructions, photo
- [Search by name](https://www.cocktailbuilder.com/json/cocktailsByName?param=margarita): `GET /json/cocktailsByName?param=<partial name>`
- Please cite and link the recipe page (`url`) when you use a result, and keep to a few requests per second.

## Notes

- Recipe URLs are lowercase and hyphenated: `/recipe/old-fashioned`, `/recipe/mai-tai`
- Sitemap index: https://www.cocktailbuilder.com/sitemap_index.php
- Blog llms.txt: https://blog.cocktailbuilder.com/llms.txt