tea.support · developer platform Encyclopedia · School · Atlas · Pu-erh · Equipment
tea.support Get a key →

THE TEA · Content API

The Chinese tea encyclopedia, as an API.

The deepest Chinese-tea dataset, built for software. 450 teas across 72 languages, every fact typed and queryable — taste, brewing, terroir, chemistry, recipes, coordinates — plus semantic search and a built-in AI sommelier. One request returns exactly what you need. No scraping, no half-translated wikis, no guessing.

Try the live demo     Interactive docs

450
teas
32
topic articles
72
languages
1.9M
fields
2,623
glossary terms

Try it · live against api.thetea.app

Glossary · 2,623 terms in your language

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 for cross-language 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.

Ready-to-use enrichment

Per tea: one-liner, summary, tasting note, food pairings, a 3-question FAQ, plus caffeine, difficulty and price tier — all 72 languages.

SEO out of the box

Localized seo_title, seo_description and keywords for every tea, in every language.

Provenance

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

Intelligence

Not just data — understanding.

On-platform vector search and an LLM grounded in the dataset. Your users describe what they want in plain language; the API answers from real teas, with sources, in any language.

Semantic search

Find teas by meaning, not keywords — “smoky oolong with caramel”, “sweet low-caffeine green for the morning”. Filter by type or province; works in 72 languages.

AI sommelier

Ask a question, get a recommendation with the exact teas it used — grounded in the data, no invented facts. /api/v2/ask

Recommendations

“More teas like this” by sensory similarity — for cross-sell, discovery and tasting flights. /api/v2/tea/{slug}/similar

The API

A handful of 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/semantic
Natural-language / “by vibe” search, with type & province filters
GET /api/v2/ask
AI sommelier — grounded answer + the teas it cited
GET /api/v2/tea/{slug}/similar
Nearest teas by sensory vector — recommendations
GET /api/v2/map · /compare · /random
Coordinates · side-by-side · discovery

Every card now carries an enrichment block (summary, tasting note, pairings, FAQ, caffeine, difficulty) and a seo block — in all 72 languages.

# 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

The same data, everywhere your users are.

MCP server

Eight tools for Claude Desktop, Cowork and any MCP client. Setup & download →

AI skill

Drop-in skill for Claude and GPT so an assistant answers from real data. Install →

llms.txt & OpenAPI

llms.txt   openapi.yaml

Chat bots

Telegram, Discord, Slack, LINE, WhatsApp, WeChat on the same backend. Set up →

Pricing

Free to explore. Paid to build.

Every plan reads the same dataset and every endpoint — semantic search and the AI sommelier included. Paid plans add languages, full field depth, bulk export and commercial rights. Less than a coffee a month.

Free

$0

Prototyping & open-source

  • English
  • Every endpoint + AI
  • 120 req / min
  • Non-commercial
Start free

Pro

$4.99/mo

Apps serving major markets

  • 7 languages
  • Full field depth
  • 600 req / min
  • Semantic + sommelier
Get access →

Expert

$9.99/mo

Production & commercial

  • All 72 languages
  • Full field depth
  • Bulk export
  • Commercial use
Get access →

Lifetime

$19.99once

Full access, locked in

  • All 72 languages
  • Full field depth
  • Pay once — no subscription
  • Commercial use
Pay once →

Lifetime is a one-time payment — $19.99 in June, $49.99 from July. Pay with card, Apple / Google Pay, Alipay, WeChat Pay and more. Preview pricing may change before the stable release. Authenticate with Authorization: Bearer <key>.