Food & drink / API GUIDE

TheCocktailDB.

Cocktail recipes searchable by name, ingredient, and drink type.

Documentation reviewed · 16 Sep 2026
Official resource ↗
AUTHENTICATIONTest key
ACCESS / PRICINGDevelopment only
EXAMPLE REQUESTIncluded below
REVIEW STATUSDocs reviewed
THE OVERVIEW

A building block for your next idea.

Create a recipe-discovery prototype with ingredient and glass information.

Know before you build

The shared key 1 is a development/education test key. Public app-store releases need a production key; some endpoints are premium.

Check current provider documentation ↗

Your first request

Start with this documented example. Replace credential placeholders with your own test credentials. Browser execution depends on the provider’s CORS policy.

cURL REQUEST EXAMPLE
curl --request GET 'https://www.thecocktaildb.com/api/json/v1/1/search.php?s=margarita'

Practical questions

What can I build with TheCocktailDB?+

Create a recipe-discovery prototype with ingredient and glass information.

Does TheCocktailDB need authentication?+

The reviewed example is listed as “Test key”. The shared key 1 is a development/education test key. Public app-store releases need a production key; some endpoints are premium.

Can I call TheCocktailDB from a browser?+

Browser access depends on the provider’s CORS policy for your origin, method, and headers. The playground makes a direct request and cannot bypass those restrictions.

Sources & confidence

Provider documentation was reviewed on 16 September 2026. This is not a live availability test or an endorsement.

Source catalogs can become outdated. Read our review and attribution policy. Plain-text guide ↗

THE REQUEST WORKBENCH

Meet the data.

Runs in your browser

Edit a request and see what comes back. Your credentials stay in page memory and go directly to the selected API provider.

01 / REQUEST
Provider docs ↗

Choose an HTTPS endpoint.

Query parameters

Authentication

Custom headers +

The browser manages Cookie, Origin, User-Agent, and other restricted headers.

CORS support is required. No proxy. No saved credentials. 30-second timeout · 2 MB response limit.

02 / RESPONSE
Ready when you are
{ }

A little curiosity.
A real response.

Send a request to explore the response.
Nothing runs automatically.

Response bodies are displayed as data. Remote HTML and scripts are never executed.

Take the request with you cURL / JavaScript

Authentication, query values, custom header values, and body content are hidden by default. Check any URL path before sharing.