Home - mkasfeldt/TheCocktailDB-Docs GitHub Wiki
The Cocktail DB is an open, crowd-sourced database of drinks and cocktails from around the world. The Cocktail DB provides an API for developers and other interested people to quickly find information about cocktails, ingredients and other cocktail related items and return the information in JSON format.
Basic functionality of the API is free to use for development and educational purposes. A production key is required when publicly releasing an application and can be obtained by subscribing through Patreon at The Cocktail DB Patreon Supporter for $3.00 a month.
The production key provides access to advanced features: multiple ingredient filters, latest images, random images, popular cocktails, and recently added cocktails. Additionally, the production key (available through Patreon subscription) allows query results of over 100 items.
The free API key allows up to 100 results per query for most search calls. The production API key provides the full results of all search calls and allows the adding of new cocktails and images. To get a production API key Subscribe to The Cocktail DB through Patreon
https://www.thecocktaildb.com/api/json/v1/Your_API_Key/API_Call.php Required_Optional_Query_String
The bold and italicized items indicate values that must be changed and are as follows:
- Your_API_Key: The free or your production API key.
- API_Call: The name of the API call (e.g. search, list, lookup).
- Required_Optional_Query_String: If the API call requires a query it will be entered at the end of the call (see the individual API calls for more details). API calls that do not require queries will not require a query.
Please refer to the individual API call for more details.
| Error | Text | Description |
|---|---|---|
| 403 | Forbidden | The server understands the request but will not authorize it. Verify your API call is well-formatted. |
| 404 | Not Found | The server cannot find the the requested page/data. Verify that the API call is valid. |
| KEY | None | The server processes the API call and returns a JSON string, but the key is not a production key. The returned JSON string will contain "Only For Patreon supporters sorry" and not provide the data you requested. Verify your production key and if needed get a subscription at The Cocktail DB Patreon Supporter. |
Email: [email protected]
Please state if you are a Patreon Supporter
The API and site will always remain free to access at its basic level. If you love The Cocktail DB and want new features, sign up as a Patreon supporter for $3.00 a month (cancel at any time).
Your support pays for the servers bandwidth and development of new features and content. Membership allows connection to the TheDataDB Discord channel, newsletter, and release notes.
