THE TEA · Content API

中国茶百科全书，以 API 形式提供.

为软件打造的最深入的中国茶数据集。 871 款茶和 157 篇专题文章，每项事实都有类型、可查询——口感、冲泡、风土、化学、配方、坐标——另有语义搜索和内置 AI 侍茶师。 1028 文章，全部 72 种语言一应俱全。一次请求即可精确返回所需内容。无需爬取，没有半吊子翻译的维基，不必猜测。

试用在线演示交互式文档

871

茶品

157

专题文章

语言

2.5M+

字段

2,623

术语词条

13,310

茶叶企业

试一试 · 直连 api.thetea.app 实时数据

术语表 · 用您的语言查茶学术语

您将获得

规范化、带类型的数据集—— 而非成块的 HTML.

精细字段

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

72 种语言

1028 文章以及每个字段，都经过翻译和跨语言忠实度验证——包括藏语、阿姆哈拉语、博杰普尔语。

结构化附加数据

感官档案、功夫泡法与西式冲泡方案、采收日历、对比图谱、地理坐标。

多语言搜索

一个端点即可匹配西里尔字母、汉字、拼音和拉丁字母书写的名称。

术语表

72 种语言的规范茶学术语——用于悬停提示、本地化和自然语言处理。

开箱即用的内容增强

每款茶：一句话简介、概述、品鉴笔记、配餐建议、含 3 个问题的常见问答，外加咖啡因、冲泡难度和价格档位——全部 72 种语言。

开箱即用的 SEO

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

来源可溯

每个数值都标明来源和审核状态。诚实、可审计的数据。

智能

不只是数据—— 更是理解.

平台内置向量检索，以及以数据集为依据的大语言模型。用户用日常语言描述需求；API 从真实存在的茶中作答，附带来源，支持任意语言。

语义搜索

按含义而非关键词找茶——“带焦糖香的烟熏乌龙”“适合早晨的低咖啡因甜润绿茶”。可按茶类或省份筛选；支持 72 种语言。

AI 侍茶师

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

寥寥几个端点。一个基础 URL.

GET /api/v2/tea/{slug}

完整茶卡——元数据、字段、感官、冲泡方案、采收、72 种名称、标签

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

单个精确字段值

GET /api/v2/teas

按茶类、国家、省份、冲泡温度、海拔、标签筛选

GET /api/v2/search

跨所有文字的多语言搜索

GET /api/v2/glossary

按语言、类别或检索词查询茶学术语

GET /api/v2/semantic

自然语言 / “凭感觉”搜索，可按茶类与省份筛选

GET /api/v2/ask

AI 侍茶师——有据可查的回答 + 其引用的茶品

GET /api/v2/tea/{slug}/similar

按感官向量找最相近的茶——推荐

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

坐标 · 并排对比 · 探索发现

GET /api/v2/categories · /term/{id} · /meta

专题文章 · 一个术语的全部语言版本 · 字段代码、标签和筛选值

GET /api/v2/companies · /company/{slug}

b2btea.com 茶叶企业名录——15 种语言，不含电子邮件地址

GET /api/v2

全部端点，以及来自数据库的实时统计

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

# 一个事实，任意语言 curl -H "Authorization: Bearer tt_your_key" "https://api.thetea.app/api/v2/tea/biluochun/ru/field/water_temp" # 推荐：可用 <= 80 C 水温冲泡的绿茶 curl "https://api.thetea.app/api/v2/teas?tea_type=green&brew_temp_max=80"

企业名录

茶背后的企业，遍及全球.

同一个 API 还开放了 b2btea.com，这份名录收录了 13,310 家茶叶企业：工厂、批发商、进口商、出口商、茶馆、市场和合作社。共十五种语言：英语、俄语、中文、德语、法语、西班牙语、意大利语、葡萄牙语、日语、韩语、土耳其语、阿拉伯语、波兰语、荷兰语和越南语。

搜索

Filter by country, city, Chinese province, company type, tea, Chinese-tea focus and evidence level. A country or a type can be given as a key or in the request language: China, Chine, Китай. /api/v2/companies

企业卡片

What the b2btea.com page shows: description, address, phone, website, contact form, teas linked to encyclopedia articles, with a link back to the page. JSON or Markdown. /api/v2/company/{slug}

从一款茶找到它的卖家

Start from an encyclopedia article and get the companies that deal in that tea. The directory tags companies by tea class and a few named teas; the answer says whether it matched the tea itself or its class. ?tea_article=pu-ercha

统计

Companies by country, type, tea, region, Chinese-tea focus and evidence level, with labels in your language. /api/v2/companies/facets

任何字段中都没有电子邮件地址。条目来自公开来源，并不声称企业目前仍在经营；每条都标有证据等级，从通过实时检查的网站，到仅被某个来源提及的名称。无密钥时，搜索只返回前 10 条结果，不支持翻页；企业卡片始终开放。

# 德国的普洱茶卖家，标签用德语 curl "https://api.thetea.app/api/v2/companies?tea_article=pu-ercha&country=Germany&lang=de" # 以 Markdown 返回一家企业 curl "https://api.thetea.app/api/v2/company/yunnan-sourcing-1.md"

AI 原生

同一份数据，覆盖用户所在的每个平台.

MCP 服务器

面向 Claude Desktop、Cowork 及任意 MCP 客户端的工具，包括 b2btea.com 企业名录。设置与下载 →

AI 技能

即插即用的 Claude 与 GPT 技能，让助手基于真实数据作答。安装 →

llms.txt 与 OpenAPI

llms.txt openapi.yaml

聊天机器人

Telegram、Discord、Slack、LINE、WhatsApp、WeChat 共用同一后端。设置 →

定价

免费探索。付费构建.

所有套餐读取的都是同一数据集、同样的全部端点——语义搜索和 AI 侍茶师也包括在内。付费套餐增加语言、完整字段深度、批量导出和商业使用权。每月花费不到一杯咖啡。

免费版

原型开发与开源项目

英语
全部端点 + AI
120 次请求 / 分钟
非商业用途

免费开始

Pro

$4.99/月

面向主要市场的应用

7 种语言
完整字段深度
600 次请求 / 分钟
语义搜索 + 侍茶师

获取访问权限 →

Expert

$9.99/月

生产环境与商业用途

全部 72 种语言
完整字段深度
批量导出
商业用途