tea.support · plataforma per a desenvolupadors Enciclopèdia · Escola · Atles · Pu-erh · Equipament
tea.support Aconsegueix una clau →

THE TEA · Content API

L'enciclopèdia del te xinès, com a API.

El conjunt de dades més profund sobre el te xinès, creat per a programari. 871 tes i 157 articles temàtics, cada dada tipificada i consultable — gust, preparació, terrer, química, receptes, coordenades — a més de cerca semàntica i un sommelier d'IA integrat. 1028 articles, tots i cadascun en els 72 idiomes. Una sola sol·licitud retorna exactament el que necessiteu. Sense scraping, sense wikis a mig traduir, sense suposicions.

Prova la demo en directe     Documentació interactiva

871
tes
157
articles temàtics
72
idiomes
2.5M+
camps
2,623
termes del glossari
13,310
empreses de te

Prova-ho · en directe contra api.thetea.app

Glossari · termes del te en el teu idioma

Què obtens

Un conjunt de dades normalitzat i tipat — no fragments HTML.

Camps granulars

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

72 idiomes

1028 articles, tots els camps, traduïts i validats per garantir la fidelitat entre idiomes, inclosos el tibetà, l'amhàric i el bhojpuri.

Extres estructurats

Perfils sensorials, receptes d'infusió gongfu i occidentals, calendaris de collita, gràfics comparatius, coordenades.

Cerca multilingüe

Un sol endpoint troba noms en ciríl·lic, han, pinyin i llatí.

Glossari

Termes canònics del te en 72 idiomes — per a tooltips, localització, PLN.

Enriquiment llest per utilitzar

Per cada te: frase curta, resum, nota de tast, maridatges, un PMF de 3 preguntes, a més de cafeïna, dificultat i franja de preu — tot en 72 idiomes.

SEO integrat

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

Procedència

Cada valor inclou la seva font i l'estat de revisió. Dades honestes i auditables.

Intel·ligència

No només dades: comprensió.

Cerca vectorial a la plataforma i un LLM arrelat al conjunt de dades. Els teus usuaris descriuen què volen en llenguatge natural; l'API respon a partir de tes reals, amb fonts, en qualsevol idioma.

Cerca semàntica

Troba tes pel significat, no per paraules clau — "oolong fumat amb caramel", "verd suau i baix en cafeïna per al matí". Filtra per tipus o província; funciona en 72 idiomes.

Sommelier d'IA

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

Recomanacions

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

L'API

Un grapat d'endpoints. Un únic URL base.

GET /api/v2/tea/{slug}
Fitxa completa del te: meta, camps, sensorial, recepta, collita, 72 noms, etiquetes
GET /api/v2/tea/{slug}/{lang}/field/{code}
Un valor de camp precís
GET /api/v2/teas
Filtra per tipus, país, província, temperatura d'infusió, altitud, etiqueta
GET /api/v2/search
Cerca multilingüe en tots els sistemes d'escriptura
GET /api/v2/glossary
Termes del te per idioma, categoria o consulta de cerca
GET /api/v2/semantic
Cerca en llenguatge natural / "per sensacions", amb filtres de tipus i província
GET /api/v2/ask
Sommelier d'IA — resposta fonamentada + els tes citats
GET /api/v2/tea/{slug}/similar
Tes més propers per vector sensorial: recomanacions
GET /api/v2/map · /compare · /random
Coordenades · costat a costat · descobriment
GET /api/v2/categories · /term/{id} · /meta
Articles temàtics · un terme en cada idioma · codis de camp, etiquetes i valors de filtre
GET /api/v2/companies · /company/{slug}
Directori d'empreses de te b2btea.com — 15 idiomes, sense adreces electròniques
GET /api/v2
Tots els endpoints, més recomptes en directe de la base de dades

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

# un fet, qualsevol idioma curl -H "Authorization: Bearer tt_your_key" "https://api.thetea.app/api/v2/tea/biluochun/ru/field/water_temp" # recomanació: tes verds infusionables a <= 80 °C curl "https://api.thetea.app/api/v2/teas?tea_type=green&brew_temp_max=80"

Directori d'empreses

Les empreses darrere del te, d'arreu del món.

La mateixa API obre b2btea.com, un directori de 13,310 empreses de te: fàbriques, majoristes, importadors, exportadors, cases de te, mercats i cooperatives. Quinze idiomes: anglès, rus, xinès, alemany, francès, castellà, italià, portuguès, japonès, coreà, turc, àrab, polonès, neerlandès i vietnamita.

Cerca

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

Fitxa d'empresa

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}

D'un te als seus venedors

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

Recomptes

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

Cap adreça electrònica, en cap camp. Les entrades provenen de fonts obertes i no afirmen que una empresa estigui en activitat avui; cadascuna porta el seu nivell d'evidència, des d'un lloc web que ha respost a una comprovació en directe fins a un nom que ha esmentat una font. Sense clau, una cerca retorna els 10 primers resultats i sense paginació; les fitxes d'empresa són sempre obertes.

# venedors de pu-erh a Alemanya, etiquetes en alemany curl "https://api.thetea.app/api/v2/companies?tea_article=pu-ercha&country=Germany&lang=de" # una empresa en Markdown curl "https://api.thetea.app/api/v2/company/yunnan-sourcing-1.md"

Natiu d'IA

Les mateixes dades, allà on siguin els teus usuaris.

Servidor MCP

Eines per a Claude Desktop, Cowork i qualsevol client MCP, inclòs el directori d'empreses b2btea.com. Configurar i descarregar →

Habilitat d'IA

Habilitat llesta per usar amb Claude i GPT perquè l'assistent respongui amb dades reals. Instal·la →

llms.txt i OpenAPI

llms.txt   openapi.yaml

Bots de xat

Telegram, Discord, Slack, LINE, WhatsApp, WeChat al mateix backend. Configurar →

Preus

Exploració gratuïta. Fet per professionals.

Cada pla llegeix el mateix conjunt de dades i cada endpoint — cerca semàntica i el sommelier IA inclosos. Els plans de pagament afegeixen idiomes, profunditat de camp completa, exportació massiva i drets comercials. Menys que un cafè al mes.

Gratuït

$0

Prototipatge i codi obert

  • English
  • Cada endpoint + IA
  • 120 sol·licituds / min
  • No comercial
Començar gratis

Pro

$4.99/mes

Aplicacions per a grans mercats

  • 7 idiomes
  • Profunditat completa dels camps
  • 600 req/min
  • Semàntic + sommelier
Obtén accés →

Expert

$9.99/mes

Producció i comercial

  • Tots els 72 idiomes
  • Profunditat completa dels camps
  • Exportació massiva
  • Ús comercial
Obtén accés →

Per a tota la vida

$19.99un cop

Accés complet, clau en mà

  • Tots els 72 idiomes
  • Profunditat completa dels camps
  • Paga un sol cop — sense subscripció
  • Ús comercial
Paga un sol cop →

El pagament vitalici és únic — $19.99 al juny, $49.99 a partir de juliol. Pay with card, Apple / Google Pay, Alipay, WeChat Pay and more. Preview pricing may change before the stable release. Authenticate with Authorization: Bearer <key>.