Ir al contenido
GET /v1/search

Search cocktails by name

Pruébalo en vivo

10 llamadas gratis al día — sin registro, sin clave API. Pasa por el gateway de oanor.

Encabezados personalizados (opcional)
api.oanor.com/cocktails-api

Funciona. Consigue una clave API y úsala en tu proyecto.

Obtener una clave API

Fragmentos de código

curl "https://api.oanor.com/cocktails-api/v1/search" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/cocktails-api/v1/search", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/cocktails-api/v1/search");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);
import requests
requests.get(
    "https://api.oanor.com/cocktails-api/v1/search",
    headers={"x-oanor-key": "oanor_test_..."}
)

Respuesta de ejemplo

Una respuesta real de este endpoint, capturada en la última comprobación de estado.

{
    "data": {
        "count": 6,
        "query": "margarita",
        "cocktails": [
            {
                "id": "11007",
                "name": "Margarita",
                "tags": [
                    "IBA",
                    "ContemporaryClassic"
                ],
                "glass": "Cocktail glass",
                "video": null,
                "category": "Ordinary Drink",
                "alcoholic": "Alcoholic",
                "thumbnail": "https://www.thecocktaildb.com/images/media/drink/5noda61589575158.jpg",
                "ingredients": [
                    {
                        "measure": "1 1/2 oz",
                        "ingredient": "Tequila"
                    },
                    {
                        "measure": "1/2 oz",
                        "ingredient": "Triple sec"
                    },
                    {
                        "measure": "1 oz",
                        "ingredient": "Lime juice"
                    },
                    {
                        "measure": null,
                        "ingredient": "Salt"
                    }
                ],
                "instructions": "Rub the rim of the glass with the lime slice to make the salt stick to it. Take care to moisten only the outer rim and sprinkle the salt on it. The salt should present to the lips of the imbiber and never mix into the cocktail. Shake the other ingredients with ice, then carefully pour into the glass."
            },
            {
                "id": "11118",
                "name": "Blue Margarita",
                "tags": [],
                "glass": "Cocktail glass",
                "video": null,
                "category": "Ordinary Drink",
                "alcoholic": "Alcoholic",
                "thumbnail": "https://www.thecocktaildb.com/images/media/drink/bry4qh1582751040.jpg",
                "ingredients": [
                    {
                        "measure": "1 1/2 oz",
                        "ingredient": "Tequila"
                    },
                    {
                        "measure": "1 oz",
                        "ingredient": "Blue Curacao"
                    },
                    {
                        "measure": "1 oz",
                        "ingredient": "Lime juice"
                    },
                    {
                        "measure": "Coarse",
                        "ingredient": "Salt"
                    }
                ],
                "instructions": "Rub rim of cocktail glass with lime juice. Dip rim in coarse salt. Shake tequila, blue curacao, and lime juice with ice, strain into the salt-rimmed glass, and serve."
            },
            {
                "id": "17216",
                "name": "Tommy's Margarita",
                "tags": [
                    "IBA",
                    "NewEra"
                ],
                "glass": "Old-Fashioned glass",
                "video": null,
                "category":
…