THE TEA · Content API

Китайська чайна енциклопедія, як API.

Найглибший набір даних про китайський чай, створений для програм. Чаїв і тематичних статей — 871 і 157 відповідно. Кожен факт типізований і доступний для запиту — смак, заварювання, теруар, хімія, рецепти, координати. Плюс семантичний пошук і вбудований ШІ-сомельє. З усіх статей 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.

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

Для кожного чаю: короткий опис, загальний огляд, нотатки дегустації, поєднання з їжею, FAQ із 3 питань, а також рівень кофеїну, складність і цінова категорія — 72 мовами.

SEO з коробки

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

Походження

Кожне значення містить джерело та статус перевірки. Чесні дані, які можна перевірити.

Аналітика

Не просто дані — розуміння.

Векторний пошук на платформі та LLM, що спирається на набір даних. Ваші користувачі описують бажане звичайною мовою; API відповідає інформацією про реальні чаї з джерелами, будь-якою мовою.

Семантичний пошук

Знаходьте чай за змістом, а не ключовими словами — «димний улун з карамеллю», «солодкий зелений з низьким вмістом кофеїну для ранку». Фільтруйте за типом або провінцією; працює 72 мовами.

ШІ-сомельє

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

ШІ-сомельє — обґрунтована відповідь + цитовані чаї

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-native

Ті самі дані, усюди, де ваші користувачі.

Сервер MCP

Інструменти для Claude Desktop, Cowork і будь-якого MCP-клієнта, зокрема довідник компаній b2btea.com. Налаштування та завантаження →

Навичка ШІ

Готовий скіл для Claude та GPT, щоб асистент відповідав на основі реальних даних. Встановити →

llms.txt та OpenAPI

llms.txt openapi.yaml

Чат-боти

Telegram, Discord, Slack, LINE, WhatsApp, WeChat на одному бекенді. Налаштувати →

Ціни

Безкоштовно для ознайомлення. Платне використання для розробки.

Кожен план читає той самий набір даних і кожен ендпоінт — семантичний пошук і AI-сомельє включено. Платні плани додають мови, повну глибину полів, масовий експорт і комерційні права. Дешевше, ніж кава на місяць.

Безкоштовно

Прототипування та відкритий код

English
Кожен ендпоінт + AI
120 запитів / хв
Некомерційний

Спробувати безкоштовно

Pro

$4.99/міс

Застосунки для основних ринків

7 мов
Повна глибина полів
600 запитів/хв
Семантика + сомельє

Отримати доступ →

Експерт

$9.99/міс

Продакшн і комерційне використання

Усі 72 мови
Повна глибина полів
Масовий експорт
Комерційне використання