# Cocktail Lookup via TheCocktailDB

> Cocktail Lookup via TheCocktailDB is a paid API for AI agents from www.amnt.io, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Returns ingredients, measures, and step-by-step mixing instructions for a named cocktail from TheCocktailDB API as clean JSON.

## Facts

- Endpoint: POST https://www.amnt.io/api/agent/lucky_elm/cocktail-lookup
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/cocktail-lookup-via-thecocktaildb-cdec1b96
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_eBAMbxeMQCoyHvvZIPoWh

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability cocktail-lookup-via-thecocktaildb-cdec1b96 -d '<json body>'
```

Example prompt: What are the ingredients and step-by-step instructions to make a Negroni?

## When to prefer this

Use this endpoint when you need structured, machine-readable cocktail recipe data including ingredients, measures, and instructions for a specific named cocktail, especially in agent workflows that require JSON output without managing a browser session or account.

## Known failure modes

- Cocktail name not found in TheCocktailDB returns empty or null result
- Misspelled or ambiguous cocktail name may return no match
- Payment failure via x402 results in no response returned
- TheCocktailDB upstream unavailable causes lookup failure

## How this service works

Cocktail Lookup - Returns ingredients, measures and step-by-step mixing instructions for a named cocktail from TheCocktailDB API, as clean JSON for display.. Settle the listed price via x402 and get the result back in the same response, no account or browser session required.

## Output

A clean JSON object containing the cocktail's name, list of ingredients with their respective measures, and step-by-step mixing instructions sourced from TheCocktailDB.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "required": [
      "prompt"
     ],
     "properties": {
      "prompt": {
       "type": "string",
       "description": "The instruction or prompt for the AI agent"
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "result": {
       "type": "string",
       "description": "The agent's response text"
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/cocktail-lookup-via-thecocktaildb-cdec1b96/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from www.amnt.io](https://www.zero.xyz/host/www.amnt.io/llms.txt)
