Sviluppatori

API delle fiere italiane

Il catalogo di trovaFiere in JSON: fiere approvate con date, luogo, coordinate, tipologia e informazioni pratiche. Per portali turistici, app di eventi, siti di Comuni e associazioni.

Gratuito

0 €

1000 richieste al giorno

Pro

19,00 €/mese

50.000 richieste al giorno

Crea una chiave

Autenticazione

Invia la chiave nell’intestazione X-Api-Key (oppure come parametro ?key=). Ogni risposta indica il limite e le richieste rimaste in X-RateLimit-Limit e X-RateLimit-Remaining.

curl -H "X-Api-Key: tf_…" "https://www.trovafiere.it/api/v1/fiere?categoria=antiquariato®ione=Toscana"

GET /api/v1/fiere

Parametro	Descrizione
`categoria`	Una tra: fumetto, antiquariato, mobile-design, arte, editoria, enogastronomia, motori, nautica, moda, tecnologia, agricoltura, artigianato, collezionismo, turismo
`regione`	Nome della regione, es. `Emilia-Romagna`
`citta`	Comune
`q`	Testo libero (nome, luogo, tipologia)
`da`, `a`	Intervallo di date `YYYY-MM-DD` (predefinito: da oggi)
`lat`, `lng`, `km`	Fiere entro `km` chilometri dal punto
`limit`, `offset`	Paginazione (massimo 200 per pagina)

{
  "data": [{
    "slug": "lucca-comics-games-2026",
    "name": "Lucca Comics & Games",
    "category": "fumetto",
    "startDate": "2026-10-28", "endDate": "2026-11-01",
    "venue": "Centro storico", "city": "Lucca", "region": "Toscana",
    "lat": 43.84, "lng": 10.50,
    "website": "https://www.luccacomicsandgames.com",
    "cancelled": false, "verified": true,
    "url": "https://www.trovafiere.it/fiere/lucca-comics-games-2026",
    "image": "https://www.trovafiere.it/og/fiera/lucca-comics-games-2026.png"
  }],
  "total": 1, "limit": 50, "offset": 0
}

GET /api/v1/fiere/:slug

Una fiera, con in più organizer, openingHours, priceInfo e ticketUrl.

Errori

400 INVALID_QUERY, 401 INVALID_KEY, 404 NOT_FOUND, 429 QUOTA_EXCEEDED, sempre nella forma { "error": { "code", "message" } }.

Condizioni

Cita trovaFiere con un link alla scheda della fiera (campo url). Le date sono indicative: chi mostra i dati deve invitare a verificarle sul sito dell’organizzatore. Niente rivendita del catalogo come tale.