il.report

il.report / api

API pubblica

Ogni indicatore pubblicato su il.report è disponibile anche come dato grezzo, in JSON o CSV, senza chiave né autenticazione. Stessi numeri e stessi periodi della pagina pubblica e del nostro database — con la fonte ufficiale sempre citata.

GET /api/series/{slug}

Restituisce i metadati della serie (titolo, unità, frequenza, fonte, nota metodologica, ultimo aggiornamento) e l'intera serie storica di osservazioni { periodo, valore }. Solo le serie pubblicate (con almeno un'osservazione, lo stesso criterio dell'indice A-Z) rispondono; le altre danno 404. Lo slugè quello nell'URL della pagina della serie, es. /euribor-3m.

GET https://il.report/api/series/euribor-3m

{
  "slug": "euribor-3m",
  "title": "Euribor 3 mesi",
  "description": "Tasso Euribor a 3 mesi, media mensile.",
  "unit": "%",
  "frequency": "monthly",
  "area": "area euro",
  "category": "tassi-mutui",
  "methodology": "…",
  "updatedAt": "2026-08-01T00:00:00.000Z",
  "source": {
    "name": "Banca Centrale Europea",
    "url": "https://www.ecb.europa.eu",
    "attribution": "Dati BCE, Statistical Data Warehouse"
  },
  "license": "https://creativecommons.org/licenses/by/4.0/",
  "observations": [
    { "period": "2026-06", "value": 2.114 },
    { "period": "2026-07", "value": 2.087 }
  ]
}

Export CSV — stesso endpoint con ?format=csv (o l'alias /api/series/{slug}/csv già linkato in ogni pagina serie): risposta text/csv con le colonne period,value, identica al JSON.

GET https://il.report/api/series/euribor-3m?format=csv

period,value
2026-06,2.114
2026-07,2.087

Attribuzione e licenza

Ogni risposta include source (nome e URL della fonte ufficiale che ha prodotto il dato) e license: l'URL della licenza formale quando è nota (es. CC BY 4.0 per ISTAT ed Eurostat), o nullquando la fonte non ne ha una pubblicata — mai un'attribuzione inventata. Chi riusa questi dati è pregato di citare sia la fonte ufficiale sia il.report. Non pubblichiamo stime o dati interpolati: ogni osservazione è quella diffusa dalla fonte per quel periodo.

Cache e limiti

Le risposte sono cacheabili (Cache-Control: public, max-age=3600): i dati cambiano alla cadenza della fonte (mensile, trimestrale o annuale secondo l'indicatore), non serve interrogare l'endpoint più spesso. Nessuna autenticazione richiesta, nessun rate limit dichiarato: uso corretto e non aggressivo.

Anche per motori di ricerca e assistenti AI

L'elenco completo degli indicatori, in formato pensato per essere letto da un LLM, è in llms.txt. Per il consumo interattivo dei dati, questa API resta il modo più diretto e verificabile.