# Decent Cocktails

> Cocktail recipes from published cocktail books, every ingredient weighed in grams and every step described, made to be mixed on the Half Decent Scale. Each recipe also has Decent's own one-line description, alcohol (ABV after dilution), sugar and acid figures, and comparisons with similar drinks. A free, read-only JSON API serves the same data.

Decent Cocktails is published by Decent Espresso Ltd at https://decentespresso.com/cocktails/. It covers two books:

- The PDT Cocktail Book (Jim Meehan, Sterling Epicure, 2011): https://decentespresso.com/cocktails/pdt/
- Death & Co: Modern Classic Cocktails (David Kaplan, Nick Fauchald and Alex Day, Ten Speed Press, 2014): https://decentespresso.com/cocktails/deathco/

## Using this data, and how to credit it

- Decent's own content is licensed under Creative Commons Attribution 4.0 (CC BY 4.0, https://creativecommons.org/licenses/by/4.0/), to the extent Decent Espresso Ltd holds rights in it: the drink descriptions, similar-drink comparisons and taste notes, the method wording, the computed ABV/sugar/acid figures, and the AI-generated drink and glass pictures.
- The recipe facts (drink names, ingredients and amounts, glass, garnish and creator credits) come from the books named above. Facts like these can't be copyrighted (US Copyright Office, Circular 33: a "mere listing of ingredients" is not protected), so Decent claims no rights in them and offers no licence for them. None of the books' own writing (stories, descriptions, instructions) is reproduced; the method wording is Decent's. Please buy the books.
- Some drink names are also trademarks (Sazerac, for example); they belong to their owners and are used only to name the drink.
- Product photographs, label artwork and trademarks of third parties are not covered by any licence from Decent.
- When you use or quote this data, credit "Decent Cocktails" with a link to the recipe's page, and name the source book. For example: "Naked and Famous, from Decent Cocktails (https://decentespresso.com/cocktails/deathco/recipes/Naked%20and%20Famous), after Death & Co: Modern Classic Cocktails by David Kaplan, Nick Fauchald and Alex Day." Every API response includes a ready-made `cite_as` line and a `license` block.

## API

- [API guide](https://decentespresso.com/cocktails/api/) (Markdown): the books, endpoints with examples, rate limit and licence
- [API index as JSON](https://decentespresso.com/cocktails/api/index.json)
- [OpenAPI description](https://decentespresso.com/cocktails/api/openapi.json)
- One recipe in full: `GET /cocktails/api/{book}/recipes/{name}` (book is `pdt` or `deathco`; name URL-encoded, e.g. `/cocktails/api/deathco/recipes/Naked%20and%20Famous`). This returns ingredients with amounts and grams, method, glass, creator credit, ABV/sugar/acid, similar drinks, picture, source book, licence and cite_as.
- Recipe names, 50 at a time: `GET /cocktails/api/{book}/recipes?offset=0&limit=50`
- Ingredients: `GET /cocktails/api/{book}/ingredients` and `GET /cocktails/api/{book}/ingredients/{name}`
- Search: `GET /cocktails/api/{book}/search?q=mezcal`
- Limit: 60 requests per minute per IP. No bulk download; please fetch only the recipes you need.

## Pages

- [All PDT recipes](https://decentespresso.com/cocktails/pdt/recipes/)
- [All Death & Co recipes](https://decentespresso.com/cocktails/deathco/recipes/)
- [Cocktails by base spirit](https://decentespresso.com/cocktails/deathco/spirits)
- [Half Decent Scale](https://decentespresso.com/scale): the Bluetooth scale the recipes are written for