tea.support · plateforme pour développeurs Encyclopédie · École · Atlas · Pu-erh · Équipement
tea.support Obtenir une clé →

THE TEA · Content API

L'encyclopédie du thé chinois, sous forme d'API.

Le jeu de données le plus approfondi sur le thé chinois, conçu pour les logiciels. 871 thés et 157 articles thématiques, chaque fait typé et interrogeable — goût, infusion, terroir, chimie, recettes, coordonnées — ainsi qu'une recherche sémantique et un sommelier IA intégré. 1028 des articles, chacun dans les 72 langues. Une seule requête renvoie exactement ce dont vous avez besoin. Pas de scraping, pas de wikis à moitié traduits, pas d'approximation.

Essayez la démo en direct     Documentation interactive

871
thés
157
articles thématiques
72
langues
2.5M+
champs
2,623
termes du glossaire
13,310
entreprises du thé

Essayez · en direct sur api.thetea.app

Glossaire · termes du thé dans votre langue

Ce que vous obtenez

Un jeu de données normalisé et typé — pas des blocs HTML.

Champs granulaires

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

72 langues

1028 les articles, chaque champ, traduits et validés pour une fidélité interlangue — y compris le tibétain, l'amharique et le bhojpuri.

Compléments structurés

Profils sensoriels, recettes d'infusion gongfu et occidentale, calendriers de récolte, graphe de comparaison, coordonnées.

Recherche multilingue

Un seul endpoint reconnaît les noms en cyrillique, en sinogrammes, en pinyin et en alphabet latin.

Glossaire

Termes canoniques du thé en 72 langues — pour les infobulles, la localisation, le NLP.

Enrichissement prêt à l'emploi

Pour chaque thé : une phrase d'accroche, un résumé, une note de dégustation, des accords mets, une FAQ de 3 questions, ainsi que la caféine, la difficulté et la gamme de prix — dans les 72 langues.

SEO clé en main

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

Provenance

Chaque valeur porte sa source et son statut de vérification. Des données honnêtes et vérifiables.

Intelligence

Pas seulement des données — de la compréhension.

Une recherche vectorielle sur la plateforme et un LLM ancré dans le jeu de données. Vos utilisateurs décrivent ce qu'ils veulent en langage courant ; l'API répond à partir de thés réels, avec leurs sources, dans n'importe quelle langue.

Recherche sémantique

Trouvez des thés par le sens, pas par mots-clés — « oolong fumé au caramel », « thé vert doux et pauvre en caféine pour le matin ». Filtrez par type ou par province ; fonctionne en 72 langues.

Sommelier IA

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

Recommandations

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

L'API

Une poignée d'endpoints. Une seule URL de base.

GET /api/v2/tea/{slug}
Fiche complète du thé — méta, champs, sensoriel, recette, récolte, 72 noms, tags
GET /api/v2/tea/{slug}/{lang}/field/{code}
La valeur précise d'un champ
GET /api/v2/teas
Filtrer par type, pays, province, température d'infusion, altitude, tag
GET /api/v2/search
Recherche multilingue dans toutes les écritures
GET /api/v2/glossary
Termes du thé par langue, catégorie ou requête de recherche
GET /api/v2/semantic
Recherche en langage naturel / « par ambiance », avec filtres par type et province
GET /api/v2/ask
Sommelier IA — réponse fondée sur les données + les thés cités
GET /api/v2/tea/{slug}/similar
Thés les plus proches par vecteur sensoriel — recommandations
GET /api/v2/map · /compare · /random
Coordonnées · comparaison côte à côte · découverte
GET /api/v2/categories · /term/{id} · /meta
Articles thématiques · un terme dans toutes les langues · codes de champs, tags et valeurs de filtre
GET /api/v2/companies · /company/{slug}
Annuaire b2btea.com des entreprises du thé — 15 langues, aucune adresse e-mail
GET /api/v2
Tous les endpoints, plus les chiffres en direct de la base de données

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

# un fait, dans n'importe quelle langue curl -H "Authorization: Bearer tt_your_key" "https://api.thetea.app/api/v2/tea/biluochun/ru/field/water_temp" # recommander : thés verts infusables à <= 80 °C curl "https://api.thetea.app/api/v2/teas?tea_type=green&brew_temp_max=80"

Annuaire des entreprises

Les entreprises derrière le thé, dans le monde entier.

La même API ouvre b2btea.com, un annuaire de 13,310 entreprises du thé : usines, grossistes, importateurs, exportateurs, maisons de thé, marchés et coopératives. Quinze langues : anglais, russe, chinois, allemand, français, espagnol, italien, portugais, japonais, coréen, turc, arabe, polonais, néerlandais et vietnamien.

Recherche

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

Fiche entreprise

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 thé à ses vendeurs

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

Décomptes

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

Aucune adresse e-mail, dans aucun champ. Les fiches proviennent de sources ouvertes et n'affirment pas qu'une entreprise est en activité aujourd'hui ; chacune indique son niveau de preuve, d'un site web qui a répondu à une vérification en direct à un nom cité par une source. Sans clé, une recherche renvoie les 10 premiers résultats, sans pagination ; les fiches d'entreprise sont toujours accessibles.

# vendeurs de pu-erh en Allemagne, libellés en allemand curl "https://api.thetea.app/api/v2/companies?tea_article=pu-ercha&country=Germany&lang=de" # une entreprise en Markdown curl "https://api.thetea.app/api/v2/company/yunnan-sourcing-1.md"

Nativement IA

Les mêmes données, partout où sont vos utilisateurs.

Serveur MCP

Des outils pour Claude Desktop, Cowork et tout client MCP, y compris l'annuaire d'entreprises b2btea.com. Configuration et téléchargement →

Compétence IA

Compétence prête à l'emploi pour Claude et GPT, pour qu'un assistant réponde à partir de données réelles. Installer →

llms.txt & OpenAPI

llms.txt   openapi.yaml

Chatbots

Telegram, Discord, Slack, LINE, WhatsApp, WeChat sur le même backend. Configurer →

Tarifs

Gratuit pour explorer. Payant pour construire.

Chaque forfait donne accès au même jeu de données et à tous les endpoints — recherche sémantique et sommelier IA compris. Les forfaits payants ajoutent des langues, toute la profondeur des champs, l'export en masse et les droits commerciaux. Moins qu'un café par mois.

Gratuit

$0

Prototypage et open source

  • Anglais
  • Tous les endpoints + IA
  • 120 req / min
  • Non commercial
Commencer gratuitement

Pro

$4.99/mois

Applications pour les grands marchés

  • 7 langues
  • Profondeur complète des champs
  • 600 req / min
  • Sémantique + sommelier
Obtenir l'accès →

Expert

$9.99/mois

Production et usage commercial

  • Les 72 langues
  • Profondeur complète des champs
  • Export en masse
  • Usage commercial
Obtenir l'accès →

À vie

$19.99une fois

Accès complet, acquis à vie

  • Les 72 langues
  • Profondeur complète des champs
  • Paiement unique — sans abonnement
  • Usage commercial
Payer une fois →

L'offre À vie est un paiement unique — $19.99 en juin, $49.99 à partir de juillet. Pay with card, Apple / Google Pay, Alipay, WeChat Pay and more. Preview pricing may change before the stable release. Authenticate with Authorization: Bearer <key>.