# THE TEA — Content API
> Open REST API: 482 Chinese teas across 72 languages, granular fields (taste, brewing, terroir, chemistry, sensory, recipes, coordinates).

Base: https://api.thetea.app
OpenAPI: https://api.thetea.app/openapi.yaml

## Endpoints
- GET /api/v2/tea/{slug}?lang= — full tea card (meta+fields+sensory+recipe+harvest+72 names+tags)
- GET /api/v2/tea/{slug}.md?lang= — same as Markdown
- GET /api/v2/tea/{slug}/{lang}/field/{code} — one field
- GET /api/v2/teas?tea_type=&country=&province=&brew_temp_max=&altitude_min=&tag=&q=&lang= — filter
- GET /api/v2/search?q=&lang= — search (Cyrillic/Hanzi/pinyin/Latin)
- GET /api/v2/map?lang= — coordinates · /api/v2/random · /api/v2/compare?slugs=a,b
- GET /api/v2/glossary?lang=&category= — 1301 terms · /api/v2/family · /api/v2/meta
Slugs are toneless pinyin (biluochun, da-hong-pao). Locales: en ru zh zh-tw ja ar … (72).