Developer Documentation

Integrate DrinkFYI data into your applications. Access cocktail recipes, ingredients, glossary terms, and guides through our JSON APIs, data feeds, and machine-readable endpoints.

API Endpoints

All API endpoints return JSON responses with Content-Type: application/json. No authentication is required. CORS is not enabled on API endpoints.

Search API

Search across cocktails, ingredients, guides, and glossary terms.

GET /api/search/?q={query}

Parameters

Name	Type	Required	Description
`q`	string	Yes	Search query, minimum 2 characters

Example Request

curl "https://drinkfyi.com/api/search/?q=margarita"

Example Response

{
  "cocktails": [
    {
      "name": "Margarita",
      "slug": "margarita",
      "type": "cocktail",
      "url": "/cocktail/margarita/"
    },
    {
      "name": "Blue Margarita",
      "slug": "blue-margarita",
      "type": "cocktail",
      "url": "/cocktail/blue-margarita/"
    }
  ],
  "ingredients": [],
  "guides": [
    {
      "name": "The Complete Guide to Margaritas",
      "slug": "complete-guide-margaritas",
      "type": "guide",
      "url": "/guide/complete-guide-margaritas/"
    }
  ],
  "glossary": []
}

Glossary Term API

Retrieve the definition and metadata for a single glossary term. Used for tooltip previews across the site.

GET /api/term/{slug}/

Parameters

Name	Type	Required	Description
`slug`	string	Yes	URL slug of the glossary term (path parameter)

Example Request

curl "https://drinkfyi.com/api/term/muddle/"

Example Response

{
  "term": "Muddle",
  "slug": "muddle",
  "definition": "To press ingredients against the side of a glass with a muddler to release flavors and essential oils.",
  "pronunciation": "MUH-dl",
  "category": "Technique",
  "url": "/glossary/muddle/"
}

404 Response: Returns a standard Django 404 HTML page if the term slug does not exist or is unpublished.

Data Feeds

Subscribe to our guide feeds to receive updates when new cocktail guides are published. We provide both RSS 2.0 and Atom 1.0 formats.

RSS 2.0 /feed/rss/

Standard RSS feed. Compatible with all feed readers.

Atom 1.0 /feed/atom/

Atom feed with richer metadata and update timestamps.

Subscribe via command line

# RSS
curl "https://drinkfyi.com/feed/rss/"

# Atom
curl "https://drinkfyi.com/feed/atom/"

HTML auto-discovery

Feed readers automatically discover our feeds via <link> tags in every page:

<link rel="alternate" type="application/rss+xml"
      title="DrinkFYI Guides (RSS)" href="/feed/rss/">
<link rel="alternate" type="application/atom+xml"
      title="DrinkFYI Guides (Atom)" href="/feed/atom/">

AI / LLM Integration

DrinkFYI provides machine-readable content summaries following the llms.txt standard. These endpoints help AI models understand and reference our content.

/llms.txt text/plain

A concise summary of DrinkFYI's content structure and key pages. Designed for AI models to quickly understand what the site offers and how it is organized.

# DrinkFYI.com

> Cocktail & beverage encyclopedia — recipes, ingredients,
  tools, and guides in 15 languages.

## Browse
- [Cocktails](https://drinkfyi.com/) — 636 cocktail recipes
- [Ingredients](https://drinkfyi.com/ingredients/) — 489 ingredients
  ...

/llms-full.txt text/plain

Extended version with complete URL patterns, i18n language codes, and page-level structure. Use this for deeper indexing and cross-referencing of DrinkFYI content.

AI Crawler Policy: Our robots.txt explicitly allows GPTBot, ClaudeBot, and Google-Extended crawlers.

SEO & Standards

Standard endpoints for search engines, crawlers, and security researchers.

Endpoint	Standard	Description
/sitemap.xml	Sitemaps 0.9	Sitemap index with 18 per-section sitemaps covering all content types
/robots.txt	REP	Crawler directives with explicit AI bot permissions
/.well-known/security.txt	RFC 9116	Security vulnerability reporting contact information

Structured Data

Every page includes JSON-LD structured data for rich search results:

Recipe — cocktail pages with ingredients, instructions, and nutrition
Article — guide pages with author, dates, and word count
DefinedTerm — glossary terms with definitions
HowTo — technique pages with step-by-step instructions
BreadcrumbList — navigation breadcrumbs on all pages
WebSite — with SearchAction for sitelinks search box

Internationalization

All content pages include hreflang alternate links for 15 languages: English (default), Korean, Japanese, Chinese (Simplified), Spanish, French, German, Portuguese, Russian, Arabic, Hindi, Thai, Vietnamese, Indonesian, and Turkish.

OpenAPI Specification

A machine-readable OpenAPI 3.0 specification is available for our JSON APIs. Use it with tools like Swagger UI, Postman, or code generators.

Download openapi.json

Fetch via command line

# Download the OpenAPI spec
curl "https://drinkfyi.com/api/openapi.json" -o openapi.json

# Pretty-print
curl -s "https://drinkfyi.com/api/openapi.json" | python -m json.tool

Rate Limits & Usage

Our APIs are free to use with no authentication required. To ensure fair access for everyone, please follow these guidelines:

Keep requests under 60 requests per minute per IP address
Include a descriptive User-Agent header identifying your application
Cache responses locally when possible — our API responses include Cache-Control headers
For bulk data access, use the sitemap to discover all URLs, then scrape individual pages

If you need higher-volume access or have integration questions, reach out via the contact in our security.txt.

Quick Reference

Search API /api/search/?q=...

Glossary Term API /api/term/{slug}/

OpenAPI Spec /api/openapi.json

RSS Feed /feed/rss/

Atom Feed /feed/atom/

llms.txt /llms.txt

llms-full.txt /llms-full.txt

Sitemap /sitemap.xml