THE TEA · Content API

Encyklopédia čínskeho čaju, ako API.

Najhlbší dataset o čínskom čaji, vytvorený pre softvér. 871 čajov a 157 tematických článkov, každý fakt je typovaný a dopytovateľný — chuť, lúhovanie, terroir, chémia, recepty, súradnice — plus sémantické vyhľadávanie a zabudovaný AI somelier. 1028 články, každý jeden vo všetkých 72 jazykoch. Jedna požiadavka vráti presne to, čo potrebujete. Žiadne scrapovanie, žiadne napoly preložené wiki, žiadne hádanie.

Vyskúšajte živé demo Interaktívna dokumentácia

871

čaje

157

tematické články

jazyky

2,5 mil.+

polia

2,623

pojmy v slovníku

13,310

čajové spoločnosti

Vyskúšajte · naživo proti api.thetea.app

Slovník pojmov · čajové pojmy vo vašom jazyku

Čo získate

Normalizovaný, typovaný dataset — nie HTML bloky.

Granulárne polia

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

72 jazykov

1028 články, každé pole, preložené a overené na medzijazykovú vernosť — vrátane tibetčiny, amharčiny a bhojpuri.

Štruktúrované doplnky

Senzorické profily, recepty na prípravu gongfu a západným spôsobom, kalendáre zberov, porovnávací graf, súradnice.

Viacjazyčné vyhľadávanie

Jeden endpoint spáruje názvy naprieč cyrilikou, čínskymi znakmi, pchin-jinom a latinkou.

Slovník pojmov

Kanonické čajové pojmy v 72 jazykoch — pre tooltipy, lokalizáciu, NLP.

Obohacovanie pripravené na použitie

Pre každý čaj: stručný popis, zhrnutie, degustačná poznámka, párovanie s jedlom, FAQ s 3 otázkami, plus kofeín, náročnosť a cenová kategória – všetko v 72 jazykoch.

SEO hneď po vybalení

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

Pôvod

Každá hodnota nesie informáciu o zdroji a stave kontroly. Čestné, auditovateľné údaje.

Inteligencia

Nie len dáta — porozumenie.

Vektorové vyhľadávanie na platforme a LLM model ukotvený v datasete. Vaši používatelia opíšu, čo chcú, bežným jazykom; API odpovedá z reálnych čajov, so zdrojmi, v akomkoľvek jazyku.

Sémantické vyhľadávanie

Hľadajte čaje podľa významu, nie kľúčových slov – „dymový oolong s karamelom“, „sladký zelený s nízkym obsahom kofeínu na ráno“. Filtrujte podľa typu alebo provincie; funguje v 72 jazykoch.

AI somelier

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

Odporúčania

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

Naživo · vyskúšať upokojujúci večerný čaj · kvetinový vysokohorský oolong · sladký zelený s nízkym obsahom kofeínu

API

Niekoľko endpointov. Jedna základná URL.

GET /api/v2/tea/{slug}

Kompletná karta čaju — meta, polia, senzorika, recept, zber, 72 názvov, štítky

GET /api/v2/tea/{slug}/{lang}/field/{code}

Jedna presná hodnota poľa

GET /api/v2/teas

Filtrovať podľa typu, krajiny, provincie, teploty lúhovania, nadmorskej výšky, značky

GET /api/v2/search

Viacjazyčné vyhľadávanie naprieč všetkými písmami

GET /api/v2/glossary

Čajové pojmy podľa jazyka, kategórie alebo vyhľadávacieho dopytu

GET /api/v2/semantic

Vyhľadávanie v prirodzenom jazyku / „podľa pocitu“ s filtrami typu a provincie

GET /api/v2/ask

AI somelier — podložená odpoveď + čaje, ktoré citoval

GET /api/v2/tea/{slug}/similar

Najbližšie čaje podľa senzorického vektora — odporúčania

GET /api/v2/map · /compare · /random

Súradnice · porovnanie vedľa seba · objavovanie

GET /api/v2/categories · /term/{id} · /meta

Tematické články · jeden pojem v každom jazyku · kódy polí, tagy a hodnoty filtrov

GET /api/v2/companies · /company/{slug}

Katalóg čajových spoločností b2btea.com — 15 jazykov, bez e-mailových adries

GET /api/v2

Každý endpoint plus aktuálne počty z databázy

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

# jeden fakt, akýkoľvek jazyk curl -H "Authorization: Bearer tt_your_key" "https://api.thetea.app/api/v2/tea/biluochun/ru/field/water_temp" # odporúčanie: zelené čaje vhodné na lúhovanie pri <= 80 °C curl "https://api.thetea.app/api/v2/teas?tea_type=green&brew_temp_max=80"

Katalóg spoločností

Spoločnosti, ktoré stoja za čajom, na celom svete.

Rovnaké API otvára b2btea.com, katalóg 13,310 čajových spoločností: továrne, veľkoobchody, dovozcovia, vývozcovia, čajovne, trhy a družstvá. Pätnásť jazykov: angličtina, ruština, čínština, nemčina, francúzština, španielčina, taliančina, portugalčina, japončina, kórejčina, turečtina, arabčina, poľština, holandčina a vietnamčina.

Vyhľadávanie

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

Karta spoločnosti

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}

Od čaju k jeho predajcom

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

Štatistiky

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

Žiadne e-mailové adresy, v žiadnom poli. Záznamy pochádzajú z otvorených zdrojov a netvrdia, že spoločnosť dnes funguje; každý nesie svoju úroveň dôkazu, od webovej stránky, ktorá odpovedala na živú kontrolu, po názov, ktorý spomenul zdroj. Bez kľúča vyhľadávanie vráti prvých 10 výsledkov, bez stránkovania; karty spoločností sú vždy otvorené.

# predajcovia pu-erhu v Nemecku, popisky v nemčine curl "https://api.thetea.app/api/v2/companies?tea_article=pu-ercha&country=Germany&lang=de" # jedna spoločnosť ako Markdown curl "https://api.thetea.app/api/v2/company/yunnan-sourcing-1.md"

Natívne AI

Rovnaké údaje, všade tam, kde sú vaši používatelia.

MCP server

Nástroje pre Claude Desktop, Cowork a ľubovoľného MCP klienta vrátane katalógu spoločností b2btea.com. Nastavenie a stiahnutie →

AI zručnosť

Okamžite použiteľný skill pre Claude a GPT, aby asistent odpovedal zo skutočných údajov. Inštalovať →

llms.txt a OpenAPI

llms.txt openapi.yaml

Chatboty

Telegram, Discord, Slack, LINE, WhatsApp, WeChat na rovnakom backende. Nastaviť →

Cenník

Voľne na preskúmanie. Platené pre vývojárov.

Každý plán číta rovnaký dataset a každý endpoint – vrátane sémantického vyhľadávania a AI someliéra. Platené plány pridávajú jazyky, úplnú hĺbku polí, hromadný export a komerčné práva. Menej ako káva na mesiac.

Free

Prototypovanie a open-source

English
Každý endpoint + AI
120 požiadaviek / min
Nekomerčné

Začať zadarmo

Pro

$4.99/mesiac

Aplikácie pre hlavné trhy

7 jazykov
Plná hĺbka polí
600 požiadaviek / min
Sémantika + somelier

Získať prístup →

Expert

$9.99/mesiac

Produkcia a komerčné použitie

Všetkých 72 jazykov
Plná hĺbka polí
Hromadný export
Komerčné využitie

Získať prístup →

Doživotný prístup je jednorazová platba — $19.99 v júni, $49.99 od júla. Pay with card, Apple / Google Pay, Alipay, WeChat Pay and more. Preview pricing may change before the stable release. Authenticate with Authorization: Bearer <key>.