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 種語言
完整欄位深度
批次匯出
商業用途