THE TEA · Content API

Энциклопедия китайского чая, как API.

Самый глубокий датасет о китайском чае, созданный для разработки. Статей о чаях — 871, обзорных — 157: 1028 — все на 72 языках. Один запрос — ровно то, что нужно. Без парсинга, без недопереведённых вики, без догадок.

Попробовать живую демку Интерактивная документация

871

чаи

157

обзорные статьи

языки

2,5 млн+

поля

2 623

термины глоссария

13 310

чайные компании

Попробовать · live на api.thetea.app

Словарь · термины о чае на вашем языке

Что вы получаете

Нормализованный, типизированный набор данных — не HTML-блоки.

Детализированные поля

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

72 языка

1028 — столько статей переведено целиком: каждое поле проверено на верность между языками, включая тибетский, амхарский, бходжпури.

Структурированные дополнения

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

Многоязычный поиск

Один endpoint сопоставляет названия на кириллице, иероглифах, пиньине и латинице.

Глоссарий

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

Готовое обогащение данных

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

SEO из коробки

Локализованные seo_title, seo_description и ключевые слова для каждого чая на каждом языке.

Происхождение

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

Аналитика

Не просто данные — понимание.

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

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

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

AI-сомелье

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

Все конечные точки и живые числа из базы

Каждая карточка несёт блок enrichment (краткое описание, дегустационная заметка, сочетания, FAQ, кофеин, сложность) и блок seo — на всех 72 языках.

# один факт, любой язык 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. Пятнадцать языков: английский, русский, китайский, немецкий, французский, испанский, итальянский, португальский, японский, корейский, турецкий, арабский, польский, нидерландский и вьетнамский.

Поиск

Фильтры по стране, городу, китайской провинции, типу компании, сорту, доле китайского чая и уровню подтверждения. Страну и тип можно писать ключом или подписью на языке запроса: China, Chine, Китай. /api/v2/companies

Карточка компании

То, что показывает страница на b2btea.com: описание, адрес, телефон, сайт, форма связи, сорта со ссылками на статьи энциклопедии и ссылка на саму страницу. JSON или Markdown. /api/v2/company/{slug}

От чая к продавцам

Начните со статьи энциклопедии и получите компании, которые работают с этим чаем. Справочник размечает компании классами чая и десятком известных сортов; ответ говорит, найдено ли совпадение по самому чаю или по его классу. ?tea_article=pu-ercha

Счётчики

Компании по странам, типам, сортам, регионам, доле китайского чая и уровню подтверждения, с подписями на вашем языке. /api/v2/companies/facets

Адресов электронной почты нет ни в одном поле. Записи собраны из открытых источников и не утверждают, что компания работает сегодня; у каждой указан уровень подтверждения — от сайта, ответившего на живую проверку, до названия, которое упомянул источник. Без ключа поиск отдаёт первые 10 результатов без листания; карточки компаний открыты всегда.

# продавцы пуэра в Германии, подписи по-русски curl "https://api.thetea.app/api/v2/companies?tea_article=pu-ercha&country=Germany&lang=ru" # одна компания в Markdown curl "https://api.thetea.app/api/v2/company/yunnan-sourcing-1.md?lang=ru"

AI-ориентированный

Те же данные, везде, где ваши пользователи.

MCP-сервер

Инструменты для Claude Desktop, Cowork и любого MCP-клиента, включая справочник чайных компаний b2btea.com. Установка и загрузка →

AI Skill

Готовый навык для Claude и GPT, чтобы ассистент отвечал на основе реальных данных. Установить →

llms.txt и OpenAPI

llms.txt openapi.yaml

Чат-боты

Telegram, Discord, Slack, LINE, WhatsApp, WeChat — на одном бэкенде. Настроить →

Цены

Изучайте бесплатно. Платный доступ к сборке.

Все планы читают один набор данных и все конечные точки, включая семантический поиск и AI-сомелье. Платные планы добавляют языки, полную глубину полей, массовый экспорт и коммерческие права. Дешевле чашки кофе в месяц.

Бесплатно

Прототипирование и открытый исходный код

Английский
Все конечные точки + AI
120 запр / мин
Некоммерческое использование

Начать бесплатно

Pro

$4.99/мес

Приложения для крупных рынков

7 языков
Полная глубина полей
600 запр / мин
Семантика + сомелье

Получить доступ →

Эксперт

$9.99/мес

Производство и коммерческое использование

Все 72 языка
Полная глубина полей
Массовый экспорт
Коммерческое использование