THE TEA · Content API

L'enciclopedia del tè cinese, come API.

Il dataset sul tè cinese più approfondito, costruito per il software. 871 tè e 157 articoli tematici, ogni fatto tipizzato e interrogabile — gusto, infusione, terroir, chimica, ricette, coordinate — più ricerca semantica e un sommelier AI integrato. 1028 articoli, ognuno in tutte le 72 lingue. Una sola richiesta restituisce esattamente ciò che ti serve. Niente scraping, niente wiki tradotte a metà, niente tentativi.

Prova la demo dal vivo Documentazione interattiva

871

tè

157

articoli tematici

lingue

2.5M+

campi

2,623

termini del glossario

13,310

aziende del tè

Provalo · live su api.thetea.app

Glossario · termini del tè nella tua lingua

Cosa ottieni

Un set di dati normalizzato e tipizzato — non blocchi HTML.

Campi granulari

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

72 lingue

1028 articoli, ogni campo, tradotti e validati per la fedeltà cross-linguistica, inclusi tibetano, amarico e bhojpuri.

Extra strutturati

Profili sensoriali, ricette di infusione gongfu e occidentale, calendari di raccolta, grafico comparativo, coordinate.

Ricerca multilingue

Un unico endpoint abbina nomi in cirillico, Han, pinyin e latino.

Glossario

Termini canonici del tè in 72 lingue — per tooltip, localizzazione, NLP.

Arricchimento pronto all'uso

Per ogni tè: descrizione breve, riassunto, nota di degustazione, abbinamenti gastronomici, un FAQ di 3 domande, più caffeina, difficoltà e fascia di prezzo — in tutte le 72 lingue.

SEO già integrato

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

Provenienza

Ogni valore riporta fonte e stato di verifica. Dati onesti e verificabili.

Intelligence

Non solo dati — comprendere.

Ricerca vettoriale on-platform e un LLM ancorato al dataset. I tuoi utenti descrivono ciò che vogliono in linguaggio naturale; l'API risponde con tè reali, con fonti, in qualsiasi lingua.

Ricerca semantica

Trova tè per significato, non per parole chiave — "oolong affumicato al caramello", "verde dolce a bassa caffeina per la mattina". Filtra per tipo o provincia; funziona in 72 lingue.

Sommelier AI

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

Raccomandazioni

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

Live · prova un tè calmante per la sera · oolong floreale d'alta montagna · tè verde dolce a basso contenuto di caffeina

L'API

Una manciata di endpoint. Un unico URL di base.

GET /api/v2/tea/{slug}

Scheda tè completa — metadati, campi, analisi sensoriale, ricetta, raccolto, 72 nomi, tag

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

Un unico valore di campo preciso

GET /api/v2/teas

Filtra per tipo, paese, provincia, temperatura d'infusione, altitudine, tag

GET /api/v2/search

Ricerca multilingue in tutti i sistemi di scrittura

GET /api/v2/glossary

Termini del tè per lingua, categoria o query di ricerca

GET /api/v2/semantic

Ricerca in linguaggio naturale / "per sensazione", con filtri per tipologia e provincia

GET /api/v2/ask

Sommelier AI — risposta fondata + i tè che ha citato

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

Tè più vicini per vettore sensoriale — raccomandazioni

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

Coordinate · affiancate · scoperta

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

Articoli tematici · un termine in ogni lingua · codici dei campi, tag e valori dei filtri

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

Elenco delle aziende del tè di b2btea.com — 15 lingue, nessun indirizzo e-mail

GET /api/v2

Ogni endpoint, più i conteggi in tempo reale dal database

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

# un fatto, qualsiasi lingua curl -H "Authorization: Bearer tt_your_key" "https://api.thetea.app/api/v2/tea/biluochun/ru/field/water_temp" # consigliato: tè verdi infusibili a <= 80°C curl "https://api.thetea.app/api/v2/teas?tea_type=green&brew_temp_max=80"

Elenco delle aziende

Le aziende dietro il tè, in tutto il mondo.

La stessa API apre b2btea.com, un elenco di 13,310 aziende del tè: fabbriche, grossisti, importatori, esportatori, case del tè, mercati e cooperative. Quindici lingue: inglese, russo, cinese, tedesco, francese, spagnolo, italiano, portoghese, giapponese, coreano, turco, arabo, polacco, olandese e vietnamita.

Ricerca

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

Scheda azienda

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}

Da un tè ai suoi venditori

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

Conteggi

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

Nessun indirizzo e-mail, in nessun campo. Le voci provengono da fonti aperte e non affermano che un'azienda sia attiva oggi; ciascuna riporta il proprio livello di evidenza, da un sito che ha risposto a una verifica dal vivo a un nome citato da una fonte. Senza chiave una ricerca restituisce i primi 10 risultati, senza paginazione; le schede delle aziende sono sempre aperte.

# venditori di pu-erh in Germania, etichette in tedesco curl "https://api.thetea.app/api/v2/companies?tea_article=pu-ercha&country=Germany&lang=de" # un'azienda in Markdown curl "https://api.thetea.app/api/v2/company/yunnan-sourcing-1.md"

Nativo AI

Gli stessi dati, ovunque siano i tuoi utenti.

Server MCP

Strumenti per Claude Desktop, Cowork e qualsiasi client MCP, incluso l'elenco delle aziende di b2btea.com. Configurazione e download →

Competenza AI

Skill plug-and-play per Claude e GPT, così l'assistente risponde con dati reali. Installa →

llms.txt & OpenAPI

llms.txt openapi.yaml

Chat bot

Telegram, Discord, Slack, LINE, WhatsApp, WeChat sullo stesso backend. Configura →

Prezzi

Esplorazione gratuita. Pagato per costruire.

Ogni piano legge lo stesso dataset e ogni endpoint — ricerca semantica e sommelier IA inclusi. I piani a pagamento aggiungono lingue, profondità completa dei campi, esportazione massiva e diritti commerciali. Meno di un caffè al mese.

Gratuito

Prototipazione e open-source

English
Ogni endpoint + IA
120 req/min
Non commerciale

Inizia gratis

Pro

$4.99/mese

App per i mercati principali

7 lingue
Profondità completa dei campi
600 richieste/min
Semantica + sommelier

Ottieni accesso →

Esperto

$9.99/mese

Produzione e commerciale

Tutte le 72 lingue
Profondità completa dei campi
Esportazione in blocco
Uso commerciale