tea.support · plataforma para desarrolladores Enciclopedia · Escuela · Atlas · Pu-erh · Utensilios
tea.support Obtén una clave →

THE TEA · Content API

La enciclopedia del té chino, como API.

El conjunto de datos sobre té chino más completo, hecho para software. 871 tés y 157 artículos temáticos, cada dato tipado y consultable — sabor, preparación, terruño, química, recetas, coordenadas — más búsqueda semántica y un sumiller de IA integrado. 1028 artículos, cada uno en los 72 idiomas. Una sola solicitud devuelve exactamente lo que necesitas. Sin scraping, sin wikis a medio traducir, sin adivinanzas.

Prueba la demo en vivo     Documentación interactiva

871
tés
157
artículos temáticos
72
idiomas
2.5M+
campos
2,623
términos del glosario
13,310
empresas de té

Pruébalo · en vivo contra api.thetea.app

Glosario · términos del té en tu idioma

Qué obtienes

Un conjunto de datos normalizado y tipado — no bloques de HTML.

Campos detallados

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

72 idiomas

1028 artículos, todos los campos, traducidos y validados para la fidelidad entre idiomas, incluidos el tibetano, el amárico y el bhojpuri.

Extras estructurados

Perfiles sensoriales, recetas de preparación gongfu y occidental, calendarios de cosecha, grafo de comparación, coordenadas.

Búsqueda multilingüe

Un solo endpoint encuentra nombres en cirílico, caracteres chinos, pinyin y alfabeto latino.

Glosario

Términos canónicos del té en 72 idiomas — para tooltips, localización, PLN.

Enriquecimiento listo para usar

Por cada té: frase de presentación, resumen, nota de cata, maridajes, 3 preguntas frecuentes, además de cafeína, dificultad y rango de precio — en los 72 idiomas.

SEO de serie

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

Procedencia

Cada valor lleva su fuente y su estado de revisión. Datos honestos y auditables.

Inteligencia

No solo datos — comprensión.

Búsqueda vectorial en la plataforma y un LLM anclado en el conjunto de datos. Tus usuarios describen lo que quieren con sus propias palabras; la API responde con tés reales, con fuentes, en cualquier idioma.

Búsqueda semántica

Encuentra tés por su significado, no por palabras clave — “oolong ahumado con caramelo”, “té verde dulce y bajo en cafeína para la mañana”. Filtra por tipo o provincia; funciona en 72 idiomas.

Sumiller de IA

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

Recomendaciones

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

La API

Unos pocos endpoints. Una sola URL base.

GET /api/v2/tea/{slug}
Ficha completa del té — metadatos, campos, perfil sensorial, receta, cosecha, 72 nombres, etiquetas
GET /api/v2/tea/{slug}/{lang}/field/{code}
Un valor de campo preciso
GET /api/v2/teas
Filtra por tipo, país, provincia, temperatura de preparación, altitud, etiqueta
GET /api/v2/search
Búsqueda multilingüe en todos los sistemas de escritura
GET /api/v2/glossary
Términos del té por idioma, categoría o búsqueda
GET /api/v2/semantic
Búsqueda en lenguaje natural / “por sensaciones”, con filtros de tipo y provincia
GET /api/v2/ask
Sumiller de IA — respuesta fundamentada + los tés que citó
GET /api/v2/tea/{slug}/similar
Tés más cercanos por vector sensorial — recomendaciones
GET /api/v2/map · /compare · /random
Coordenadas · comparación · descubrimiento
GET /api/v2/categories · /term/{id} · /meta
Artículos temáticos · un término en todos los idiomas · códigos de campo, etiquetas y valores de filtro
GET /api/v2/companies · /company/{slug}
Directorio de empresas de té b2btea.com — 15 idiomas, sin direcciones de correo electrónico
GET /api/v2
Todos los endpoints, más las cifras en vivo de la base de datos

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

# un dato, cualquier idioma curl -H "Authorization: Bearer tt_your_key" "https://api.thetea.app/api/v2/tea/biluochun/ru/field/water_temp" # recomendar: tés verdes que se preparan a <= 80 C curl "https://api.thetea.app/api/v2/teas?tea_type=green&brew_temp_max=80"

Directorio de empresas

Las empresas detrás del té, en todo el mundo.

La misma API da acceso a b2btea.com, un directorio de 13,310 empresas de té: fábricas, mayoristas, importadores, exportadores, casas de té, mercados y cooperativas. Quince idiomas: inglés, ruso, chino, alemán, francés, español, italiano, portugués, japonés, coreano, turco, árabe, polaco, neerlandés y vietnamita.

Búsqueda

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

Ficha de 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}

De un té a quienes lo venden

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

Recuentos

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

Sin direcciones de correo electrónico, en ningún campo. Las entradas proceden de fuentes abiertas y no afirman que una empresa siga operando hoy; cada una indica su nivel de evidencia, desde un sitio web que respondió a una comprobación en vivo hasta un nombre mencionado por una fuente. Sin clave, una búsqueda devuelve los 10 primeros resultados, sin paginación; las fichas de empresa están siempre abiertas.

# vendedores de pu-erh en Alemania, etiquetas en alemán 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"

Nativo de IA

Los mismos datos, allí donde estén tus usuarios.

Servidor MCP

Herramientas para Claude Desktop, Cowork y cualquier cliente MCP, incluido el directorio de empresas b2btea.com. Configuración y descarga →

Habilidad de IA

Habilidad lista para usar en Claude y GPT, para que un asistente responda con datos reales. Instalar →

llms.txt y OpenAPI

llms.txt   openapi.yaml

Bots de chat

Telegram, Discord, Slack, LINE, WhatsApp y WeChat sobre el mismo backend. Configurar →

Precios

Gratis para explorar. De pago para crear.

Todos los planes leen el mismo conjunto de datos y todos los endpoints — búsqueda semántica y sumiller de IA incluidos. Los planes de pago añaden idiomas, profundidad completa de campos, exportación masiva y derechos comerciales. Menos que un café al mes.

Gratis

$0

Prototipos y código abierto

  • Inglés
  • Todos los endpoints + IA
  • 120 solicitudes / min
  • No comercial
Empieza gratis

Pro

$4.99/mes

Apps para los grandes mercados

  • 7 idiomas
  • Profundidad completa de campos
  • 600 solicitudes / min
  • Semántica + sumiller
Obtén acceso →

Experto

$9.99/mes

Producción y uso comercial

  • Los 72 idiomas
  • Profundidad completa de campos
  • Exportación masiva
  • Uso comercial
Obtén acceso →

Vitalicio

$19.99una vez

Acceso completo, para siempre

  • Los 72 idiomas
  • Profundidad completa de campos
  • Pago único — sin suscripción
  • Uso comercial
Paga una vez →

El plan Vitalicio es un pago único — $19.99 en junio, $49.99 desde julio. Pay with card, Apple / Google Pay, Alipay, WeChat Pay and more. Preview pricing may change before the stable release. Authenticate with Authorization: Bearer <key>.