tea.support · nền tảng nhà phát triển Bách khoa thư · Trường học · Tập bản đồ · Phổ Nhĩ · Dụng cụ pha
tea.support Lấy khóa →

THE TEA · Content API

Bách khoa toàn thư trà Trung Hoa, dưới dạng API.

Bộ dữ liệu trà Trung Hoa sâu nhất, được xây dựng cho phần mềm. 871 loại trà và 157 bài viết chuyên đề, mọi dữ kiện đều được định kiểu và có thể truy vấn — hương vị, cách pha, thổ nhưỡng, hóa học, công thức, tọa độ — cùng tìm kiếm ngữ nghĩa và một sommelier AI tích hợp sẵn. 1028 bài viết, mỗi bài bằng tất cả 72 ngôn ngữ. Một yêu cầu trả về chính xác những gì bạn cần. Không cào dữ liệu, không wiki dịch nửa vời, không phỏng đoán.

Dùng thử bản demo trực tiếp     Tài liệu tương tác

871
các loại trà
157
bài viết chủ đề
72
ngôn ngữ
2.5M+
trường dữ liệu
2,623
thuật ngữ chuyên ngành
13,310
công ty trà

Dùng thử · trực tiếp với api.thetea.app

Bảng thuật ngữ · thuật ngữ trà bằng ngôn ngữ của bạn

Những gì bạn nhận được

Bộ dữ liệu được chuẩn hóa, có định dạng — không phải các khối HTML.

Trường dữ liệu chi tiết

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

72 ngôn ngữ

1028 bài viết, mọi trường, được dịch và kiểm chứng độ trung thực xuyên ngôn ngữ — bao gồm tiếng Tạng, Amharic, Bhojpuri.

Tiện ích mở rộng có cấu trúc

Hồ sơ cảm quan, công thức pha kiểu gongfu và phương Tây, lịch thu hoạch, biểu đồ so sánh, tọa độ.

Tìm kiếm đa ngôn ngữ

Một endpoint khớp tên trên các hệ chữ Cyrillic, Hán, bính âm và Latin.

Bảng thuật ngữ

Thuật ngữ trà chuẩn bằng 72 ngôn ngữ — cho chú giải công cụ, bản địa hóa, NLP.

Dữ liệu bổ trợ sẵn sàng sử dụng

Mỗi loại trà: mô tả ngắn, tóm tắt, hương vị, gợi ý món ăn kèm, FAQ 3 câu hỏi, cùng mức caffeine, độ khó và phân khúc giá — đầy đủ 72 ngôn ngữ.

SEO tích hợp sẵn

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

Xuất xứ

Mỗi giá trị đều mang nguồn gốc và trạng thái đánh giá. Dữ liệu trung thực, có thể kiểm toán.

Thông minh

Không chỉ là dữ liệu — sự thấu hiểu.

Tìm kiếm vector ngay trên nền tảng và một LLM được neo theo tập dữ liệu. Người dùng của bạn mô tả điều họ muốn bằng ngôn ngữ đời thường; API trả lời từ các loại trà thực tế, kèm nguồn gốc, bằng mọi ngôn ngữ.

Tìm kiếm ngữ nghĩa

Tìm trà theo ý nghĩa, không phải từ khóa — “oolong khói vị caramel”, “trà xanh ít caffeine ngọt dịu cho buổi sáng”. Lọc theo loại hoặc tỉnh thành; hoạt động với 72 ngôn ngữ.

Sommelier AI

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

Gợi ý

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

API

Một vài endpoints. Một URL gốc duy nhất.

GET /api/v2/tea/{slug}
Thẻ trà đầy đủ — meta, trường dữ liệu, cảm quan, công thức, vụ thu hoạch, 72 tên gọi, thẻ
GET /api/v2/tea/{slug}/{lang}/field/{code}
Một giá trị trường chính xác
GET /api/v2/teas
Lọc theo loại, quốc gia, tỉnh thành, nhiệt độ pha, độ cao, thẻ
GET /api/v2/search
Tìm kiếm đa ngôn ngữ trên mọi hệ chữ viết
GET /api/v2/glossary
Thuật ngữ trà theo ngôn ngữ, danh mục hoặc truy vấn tìm kiếm
GET /api/v2/semantic
Tìm kiếm bằng ngôn ngữ tự nhiên / "theo cảm nhận", kèm bộ lọc loại & vùng trồng
GET /api/v2/ask
Sommelier AI — câu trả lời có căn cứ + các loại trà được trích dẫn
GET /api/v2/tea/{slug}/similar
Trà tương đồng nhất theo vector cảm quan — gợi ý
GET /api/v2/map · /compare · /random
Tọa độ · so sánh trực quan · khám phá
GET /api/v2/categories · /term/{id} · /meta
Bài viết chuyên đề · một thuật ngữ bằng mọi ngôn ngữ · mã trường, thẻ và giá trị bộ lọc
GET /api/v2/companies · /company/{slug}
Danh bạ công ty trà b2btea.com — 15 ngôn ngữ, không có địa chỉ e-mail
GET /api/v2
Mọi endpoint, kèm số liệu trực tiếp từ cơ sở dữ liệu

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

# một sự thật, bất kỳ ngôn ngữ nào curl -H "Authorization: Bearer tt_your_key" "https://api.thetea.app/api/v2/tea/biluochun/ru/field/water_temp" # gợi ý: trà xanh pha được ở nhiệt độ <= 80°C curl "https://api.thetea.app/api/v2/teas?tea_type=green&brew_temp_max=80"

Danh bạ công ty

Những công ty đứng sau tách trà, trên toàn thế giới.

Cùng API này còn mở ra b2btea.com, danh bạ gồm 13,310 công ty trà: nhà máy, nhà bán buôn, nhà nhập khẩu, nhà xuất khẩu, quán trà, chợ và hợp tác xã. Mười lăm ngôn ngữ: tiếng Anh, tiếng Nga, tiếng Trung, tiếng Đức, tiếng Pháp, tiếng Tây Ban Nha, tiếng Ý, tiếng Bồ Đào Nha, tiếng Nhật, tiếng Hàn, tiếng Thổ Nhĩ Kỳ, tiếng Ả Rập, tiếng Ba Lan, tiếng Hà Lan và tiếng Việt.

Tìm kiếm

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

Thẻ công ty

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}

Từ một loại trà đến người bán

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

Thống kê

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

Không có địa chỉ e-mail ở bất kỳ trường nào. Các mục được lấy từ nguồn mở và không khẳng định rằng công ty vẫn đang hoạt động; mỗi mục ghi rõ mức độ bằng chứng, từ một trang web đã phản hồi lần kiểm tra trực tiếp đến một cái tên được một nguồn nhắc tới. Khi không có khóa, tìm kiếm trả về 10 kết quả đầu tiên và không phân trang; thẻ công ty luôn mở.

# người bán trà Phổ Nhĩ ở Đức, nhãn bằng tiếng Đức curl "https://api.thetea.app/api/v2/companies?tea_article=pu-ercha&country=Germany&lang=de" # một công ty dưới dạng Markdown curl "https://api.thetea.app/api/v2/company/yunnan-sourcing-1.md"

AI thuần chủng

Cùng một dữ liệu đó, mọi nơi người dùng của bạn hiện diện.

MCP server

Công cụ cho Claude Desktop, Cowork và mọi ứng dụng khách MCP, bao gồm danh bạ công ty b2btea.com. Thiết lập & Tải xuống →

Kỹ năng AI

Kỹ năng cắm-chạy cho Claude và GPT để trợ lý trả lời từ dữ liệu thực. Cài đặt →

llms.txt & OpenAPI

llms.txt   openapi.yaml

Chat bot

Telegram, Discord, Slack, LINE, WhatsApp, WeChat trên cùng một backend. Thiết lập →

Bảng giá

Miễn phí khám phá. Trả phí để xây dựng.

Mọi gói đều đọc cùng một tập dữ liệu và mọi endpoint — bao gồm tìm kiếm ngữ nghĩa và AI sommelier. Gói trả phí bổ sung ngôn ngữ, độ sâu trường dữ liệu đầy đủ, xuất hàng loạt và quyền thương mại. Chi phí chưa đến một ly cà phê mỗi tháng.

Miễn phí

$0

Tạo mẫu & mã nguồn mở

  • Tiếng Anh
  • Mọi endpoint + AI
  • 120 yêu cầu / phút
  • Phi thương mại
Dùng thử miễn phí

Pro

$4.99/tháng

Ứng dụng phục vụ thị trường lớn

  • 7 ngôn ngữ
  • Độ sâu trường dữ liệu đầy đủ
  • 600 yêu cầu / phút
  • Ngữ nghĩa + chuyên gia trà
Nhận quyền truy cập →

Chuyên gia

$9.99/tháng

Thương mại & sản xuất

  • Tất cả 72 ngôn ngữ
  • Độ sâu trường dữ liệu đầy đủ
  • Xuất hàng loạt
  • Sử dụng thương mại
Nhận quyền truy cập →

Trọn đời

$19.99một lần

Truy cập đầy đủ, cố định

  • Tất cả 72 ngôn ngữ
  • Độ sâu trường dữ liệu đầy đủ
  • Thanh toán một lần — không thuê bao
  • Sử dụng thương mại
Thanh toán một lần →

Trọn đời là khoản thanh toán một lần — $19.99 trong tháng 6, $49.99 từ tháng 7. Pay with card, Apple / Google Pay, Alipay, WeChat Pay and more. Preview pricing may change before the stable release. Authenticate with Authorization: Bearer <key>.