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 статии, всяко поле, преведени и проверени за междуезикова точност — включително тибетски, амхарски, бходжпури.

Структурирани екстри

Сензорни профили, рецепти за приготвяне гунфу и западен стил, календари на реколта, сравнителна графика, координати.

Многоезично търсене

Един endpoint открива имена на кирилица, хан, пинин и латиница.

Речник

Канонични чайни термини на 72 езика — за подсказки, локализация, NLP.

Готово обогатяване на данни

За всеки чай: кратко описание, резюме, дегустационна бележка, комбинации с храна, ЧЗВ от 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-то

Няколко endpoint-а. Един основен 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

Всички endpoint-и плюс актуални числа от базата данни

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 на един и същ бекенд. Настройка →

Цени

Свободно изследване. Платено за създаване.

Всеки план чете същия набор от данни и всеки endpoint — включени са семантично търсене и AI сомелиер. Платените планове добавят езици, пълна дълбочина на полетата, масов експорт и търговски права. По-малко от едно кафе на месец.

Безплатен

Прототипиране и отворен код

English
Всеки endpoint + AI
120 заявки / мин.
Нетърговска

Започни безплатно

Pro

$4.99/мес.

Приложения за ключови пазари

7 езика
Пълна дълбочина на полетата
600 заявки / мин
Семантика + сомелие

Получете достъп →

Експерт

$9.99/мес.

Продуктова и комерсиална употреба

Всички 72 езика
Пълна дълбочина на полетата
Масово експортиране
Търговска употреба