tea.support · 開發者平台 百科全書 · 學校 · 地圖集 · 普洱 · 器材
tea.support 取得金鑰 →

THE TEA · Content API

中國茶百科全書, 以 API 形式.

專為軟件而設、最深入嘅中國茶數據集。 871 款茶同 157 篇主題文章,每項事實都已分類並可供查詢——味道、沖泡、風土、化學、茶譜、座標——仲有語義搜尋同內置 AI 侍茶師。 1028 涵蓋全部 72 種語言嘅每篇文章。一個請求就準確攞到你所需嘅內容。唔使爬蟲、唔會有翻譯到一半嘅 wiki、唔使估估下。

試用即時示範     互動文檔

871
茶葉
157
主題文章
72
語言
2.5M+
欄位
2,623
詞彙
13,310
茶葉公司

即試 · 對接 api.thetea.app 實時數據

術語詞彙表 · 用你嘅語言查茶葉術語

你得到嘅嘢

一個標準化、強類型嘅數據集 — 並非 HTML 程式碼片段.

精細欄位

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

72 種語言

1028 文章及每個欄位均經翻譯及驗證,確保跨語言嘅忠實度——包括藏文、阿姆哈拉文同博杰普爾文。

結構化附加內容

感官風味檔案、功夫茶與西式沖泡配方、採收日曆、對比圖表、座標。

多語言搜尋

單一 endpoint 就可以匹配西里爾字母、漢字、拼音同拉丁字母之間嘅名稱。

術語詞彙表

72 種語言嘅規範茶葉用語——適用於工具提示、本地化同自然語言處理。

即用內容增強

每款茶包含:一句總結、概要、品嚐筆記、食物配搭、3 條常見問題,以及咖啡因含量、難度同價格等級 — 全部支援 72 種語言。

開箱即用 SEO

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

來源可溯

每個數值都附有來源同審核狀態。誠實、可供審計嘅數據。

智能

唔單止係數據 — 更係理解.

平台內置向量搜尋,以及一個以數據集為基礎嘅 LLM。你嘅用戶用自然語言描述想要啲乜;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

推薦

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

API

幾個簡潔嘅端點。 單一基礎 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 技能,等 AI 助理用真實數據回答問題。 安裝 →

llms.txt 同 OpenAPI

llms.txt   openapi.yaml

聊天機械人

同一個後台整合 Telegram、Discord、Slack、LINE、WhatsApp 同 WeChat。 開始設定 →

定價

免費探索。 付費開發.

所有計劃都能讀取同一數據集同每一個 endpoint —— 已包含語義搜尋同 AI 侍茶師。付費計劃額外增加語言、完整欄位深度、批量匯出同商業使用權。每月平過一杯咖啡。

免費

$0

原型設計及開源項目

  • 英文
  • 所有 Endpoint + AI
  • 每分鐘 120 次請求
  • 非商業用途
免費開始

Pro

$4.99/月

服務主要市場嘅應用程式

  • 7 種語言
  • 完整欄位深度
  • 每分鐘 600 次請求
  • 語義 + 侍茶師
立即存取 →

Expert

$9.99/月

生產及商業用途

  • 全部 72 種語言
  • 完整欄位深度
  • 批量匯出
  • 商業用途
立即存取 →

永久

$19.99單次

完整存取,鎖定不變

  • 全部 72 種語言
  • 完整欄位深度
  • 一次性付款 — 無需訂閱
  • 商業用途
一次性付款 →

永久方案為一次性付款 — 六月$19.99,七月起$49.99. Pay with card, Apple / Google Pay, Alipay, WeChat Pay and more. Preview pricing may change before the stable release. Authenticate with Authorization: Bearer <key>.