The Tea · Public APIs & AI

One endpoint away from every tea we have catalogued.

Query the encyclopedia. Recommend a brew. Ask the sommelier in plain language. Same auth, four SDKs, one rate limit.

read the docs try the sommelier

What you can ask the API

full reference →
Encyclopedia

1,840 teas, six categories, one schema

Every entry includes lineage, region, and recommended brew. Pinyin is italic with tone marks throughout the response.

Brew Compute

Suggest, don't dictate

Given a vessel, water profile, and the leaf at hand, the API returns a suggested infusion ladder. You decide when to stop.

Sommelier RAG

Cited, never invented

Conversation is grounded in the encyclopedia. Every claim cites a slug, a region, or a study. No hallucinated harvests.

Steep, in four steps

01
Get a key
Two minutes. Free tier covers reads. No card.
02
Pick an SDK
Python, JS, Swift, Kotlin. Same shape, same names.
03
List a tea
GET /v1/teas — cursor pagination, stable order.
04
Ask aloud
POST /v1/sommelier/chat — natural language, cited.
1,840 Teas catalogued
99.98% API uptime, 90 d
42 ms Median p50, EU-west
0 Hallucinated harvests