THE TEA · Content API

Encyklopedie čínského čaje, jako API.

Nejhlubší dataset o čínském čaji, vytvořený pro software. 871 čajů a 157 tematických článků, každý údaj typovaný a dotazovatelný — chuť, příprava, terroir, chemie, recepty, souřadnice — plus sémantické vyhledávání a vestavěný AI someliér. 1028 články, každý ve všech 72 jazycích. Jeden požadavek vrátí přesně to, co potřebujete. Žádné scrapování, žádné napůl přeložené wiki, žádné hádání.

Vyzkoušet živé demo Interaktivní dokumentace

871

čaje

157

tematické články

jazyky

2.5M+

pole

2,623

pojmy ve slovníčku

13,310

čajové firmy

Vyzkoušet · živě proti api.thetea.app

Glosář · čajové termíny ve vašem jazyce

Co získáte

Normalizovaná, typovaná datová sada — ne HTML blob.

Granulární pole

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

72 jazyků

1028 články, každé pole, přeložené a ověřené pro věrnost napříč jazyky — včetně tibetštiny, amharštiny a bhódžpurštiny.

Strukturované doplňky

Senzorické profily, recepty na přípravu gongfu i západním stylem, kalendáře sklizní, srovnávací grafy, souřadnice.

Vícejazyčné vyhledávání

Jeden endpoint porovnává názvy napříč cyrilicí, čínskými znaky, pchin-jinem a latinkou.

Glosář

Kanonické čajové termíny v 72 jazycích — pro tooltipy, lokalizaci, NLP.

Obohacení dat připravené k okamžitému použití

Pro každý čaj: krátký popis, shrnutí, degustační poznámka, párování s jídlem, FAQ se 3 otázkami, plus kofein, obtížnost a cenová hladina — vše v 72 jazycích.

SEO hned po vybalení

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

Původ

Každá hodnota nese svůj zdroj a stav ověření. Poctivá, auditovatelná data.

Inteligence

Nejen data — porozumění.

Vektorové vyhledávání na platformě a LLM ukotvený v datové sadě. Vaši uživatelé popíší, co chtějí, běžným jazykem; API odpovídá ze skutečných čajů, se zdroji, v jakémkoli jazyce.

Sémantické vyhledávání

Najděte čaje podle významu, ne klíčových slov – „kouřový oolong s karamelem“, „sladký zelený s nízkým obsahem kofeinu na ráno“. Filtrujte podle typu nebo provincie; funguje v 72 jazycích.

AI someliér

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

Doporučení

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

Živě · vyzkoušet uklidňující večerní čaj · květinový vysokohorský oolong · sladký zelený s nízkým obsahem kofeinu

API

Několik endpointů. Jedna základní URL.

GET /api/v2/tea/{slug}

Kompletní čajová karta — meta, pole, senzorika, recept, sklizeň, 72 názvů, štítky

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

Jedna přesná hodnota pole

GET /api/v2/teas

Filtrovat podle typu, země, provincie, teploty louhování, nadmořské výšky, štítku

GET /api/v2/search

Vícejazyčné vyhledávání napříč všemi písmy

GET /api/v2/glossary

Čajové termíny podle jazyka, kategorie nebo vyhledávacího dotazu

GET /api/v2/semantic

Hledání v přirozeném jazyce / „podle pocitu“, s filtry typu a provincie

GET /api/v2/ask

AI someliér — podložená odpověď + čaje, na které se odkazuje

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

Nejbližší čaje podle senzorického vektoru — doporučení

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

Souřadnice · porovnání · objevování

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

Tematické články · jeden termín v každém jazyce · kódy polí, tagy a hodnoty filtrů

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

Adresář čajových firem b2btea.com — 15 jazyků, žádné e-mailové adresy

GET /api/v2

Všechny endpointy a k tomu aktuální počty z databáze

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

# jeden fakt, jakýkoli jazyk curl -H "Authorization: Bearer tt_your_key" "https://api.thetea.app/api/v2/tea/biluochun/ru/field/water_temp" # doporučení: zelené čaje louhovatelné při <= 80 °C curl "https://api.thetea.app/api/v2/teas?tea_type=green&brew_temp_max=80"

Adresář firem

Firmy, které stojí za čajem, z celého světa.

Stejné API zpřístupňuje b2btea.com, adresář 13,310 čajových firem: výrobny, velkoobchody, dovozci, vývozci, čajovny, tržnice a družstva. Patnáct jazyků: angličtina, ruština, čínština, němčina, francouzština, španělština, italština, portugalština, japonština, korejština, turečtina, arabština, polština, nizozemština a vietnamština.

Vyhledávání

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 firmy

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 čaje k jeho prodejcům

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

Počty

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

Žádné e-mailové adresy, v žádném poli. Záznamy pocházejí z otevřených zdrojů a netvrdí, že firma dnes působí; každý nese svou úroveň doložení, od webu, který odpověděl na živou kontrolu, až po název zmíněný některým zdrojem. Bez klíče vrátí vyhledávání prvních 10 výsledků a žádné stránkování; karty firem jsou vždy volně přístupné.

# prodejci pu-erhu v Německu, popisky v němčině curl "https://api.thetea.app/api/v2/companies?tea_article=pu-ercha&country=Germany&lang=de" # jedna firma jako Markdown curl "https://api.thetea.app/api/v2/company/yunnan-sourcing-1.md"

Nativní pro AI

Stejná data, všude tam, kde jsou vaši uživatelé.

MCP server

Nástroje pro Claude Desktop, Cowork a libovolného MCP klienta, včetně adresáře firem b2btea.com. Nastavení a stažení →

Dovednost AI

Okamžitě použitelný skill pro Claude a GPT, díky kterému asistent odpovídá na základě reálných dat. Instalovat →

llms.txt & OpenAPI

llms.txt openapi.yaml

Chatovací boti

Telegram, Discord, Slack, LINE, WhatsApp, WeChat na jednom backendu. Nastavit →

Ceník

Volně k prozkoumání. Placené vytváření.

Každý tarif čte stejný dataset a každý endpoint — včetně sémantického vyhledávání a AI sommeliéra. Placené tarify přidávají jazyky, plnou hloubku polí, hromadný export a komerční práva. Méně než za jednu kávu měsíčně.

Zdarma

Prototypování a open-source

English
Každý endpoint + AI
120 pož. / min
Nekomerční

Začít zdarma

Pro

$4.99/měsíc

Aplikace obsluhující hlavní trhy

7 jazyků
Plná hloubka polí
600 dotazů/min
Sémantika + sommelier

Získat přístup →

Expert

$9.99/měsíc

Produkční a komerční

Všech 72 jazyků
Plná hloubka polí
Hromadný export
Komerční využití

Získat přístup →

Doživotní licence je jednorázová platba — 19,99 $ v červnu, 49,99 $ od července. Pay with card, Apple / Google Pay, Alipay, WeChat Pay and more. Preview pricing may change before the stable release. Authenticate with Authorization: Bearer <key>.