THE TEA · Content API

The Chinese tea encyclopedia, as an API.

450 Chinese teas — plus 32 topic articles — described across 72 languages and broken into queryable fields: taste, brewing, terroir, chemistry, sensory profiles, recipes, harvest, coordinates. One request returns exactly the fact you need, in any language.

Try the live demo Interactive docs

450

teas

topic articles

languages

1.9M

fields

2,623

glossary terms

Try it · live against api.thetea.app

What you get

A normalized, typed dataset — not HTML blobs.

Granular fields

Fetch organoleptic.taste, brewing.water_temp, terroir.altitude directly — no scraping.

72 languages

Every tea, every field, translated and validated to ~98% faithfulness — including Tibetan, Amharic, Bhojpuri.

Structured extras

Sensory profiles, gongfu and western brewing recipes, harvest calendars, comparison graph, coordinates.

Multilingual search

One endpoint matches names across Cyrillic, Han, pinyin and Latin.

Glossary

2,623 canonical tea terms in 72 languages — for tooltips, localization, NLP.

Provenance

Each value carries its source and review status. Honest, auditable data.

The API

Eight endpoints. One base URL.

GET /api/v2/tea/{slug}

Full tea card — meta, fields, sensory, recipe, harvest, 72 names, tags

GET /api/v2/tea/{slug}/{lang}/field/{code}

One precise field value

GET /api/v2/teas

Filter by type, country, province, brewing temperature, altitude, tag

GET /api/v2/search

Multilingual search across all scripts

GET /api/v2/glossary

2,623 terms (1,322 lexicon added)

GET /api/v2/map · /compare · /random

Coordinates · side-by-side · discovery

# one fact, any language curl "https://api.thetea.app/api/v2/tea/biluochun/ru/field/water_temp" # recommend: green teas brewable at <= 80 C curl "https://api.thetea.app/api/v2/teas?tea_type=green&brew_temp_max=80"

AI-native