# Treniamo

Version: 1.0.0
Last Updated: 2026-02-08
Changelog: Initial release with full API documentation

> Piattaforma italiana per il monitoraggio treni in tempo reale. Ritardi, partenze, arrivi per Trenitalia, Italo e treni regionali su oltre 2.800 stazioni. Dati aggiornati: Gennaio 2026.

Treniamo fornisce stato treni in tempo reale, statistiche di puntualità e informazioni stazioni per tutte le ferrovie italiane. I dati vengono aggiornati ogni 1-3 minuti da fonti pubblicamente accessibili.

## Funzionalità Principali

- [Cerca Treno](https://treniamo.it/it/treno): Cerca qualsiasi treno per numero e visualizza stato in tempo reale
- [Stazioni](https://treniamo.it/it/stazione): Partenze e arrivi in tempo reale per oltre 2.800 stazioni
- [Mappa Live](https://treniamo.it/it/map): Visualizza tutti i treni sulla mappa in tempo reale
- [Statistiche Puntualità](https://treniamo.it/it/puntualita): Analisi ritardi e percentuali di puntualità

## Stazioni Principali

- [Roma Termini](https://treniamo.it/it/stazione/S08409-roma-termini): La stazione più grande d'Italia
- [Milano Centrale](https://treniamo.it/it/stazione/S01700-milano-centrale): Hub principale del Nord Italia
- [Napoli Centrale](https://treniamo.it/it/stazione/S09218-napoli-centrale): Principale stazione del Sud
- [Firenze S.M.N.](https://treniamo.it/it/stazione/S06421-firenze-s-m-n): Stazione centrale di Firenze
- [Bologna Centrale](https://treniamo.it/it/stazione/S05043-bologna-centrale): Nodo ferroviario centrale
- [Torino Porta Nuova](https://treniamo.it/it/stazione/S00219-torino-porta-nuova): Stazione principale di Torino
- [Venezia Santa Lucia](https://treniamo.it/it/stazione/S02593-venezia-santa-lucia): Stazione di Venezia

## Domande Frequenti

### Come verifico se il mio treno è in ritardo?
Cerca il numero del treno su treniamo.it/it/treno. Vedrai ritardo attuale, posizione sulla mappa e orari previsti. I dati si aggiornano ogni 1-3 minuti.

### Treniamo è un servizio ufficiale?
No. Treniamo è un servizio indipendente che utilizza dati pubblicamente accessibili. Non siamo affiliati con Trenitalia, Italo o RFI.

### Quali operatori ferroviari copre Treniamo?
Trenitalia (Frecciarossa, Frecciargento, Frecciabianca, Intercity, Regionali), Italo, Trenord e altri operatori regionali.

### I dati sono affidabili?
I dati provengono dalle stesse fonti utilizzate dalle app ufficiali. Aggiornamento ogni 1-3 minuti. Per decisioni importanti, consigliamo di verificare anche sui canali ufficiali.

### Treniamo è gratuito?
Sì, completamente gratuito e senza registrazione.

## Statistiche Servizio

- Stazioni monitorate: oltre 2.800
- Treni tracciati: tutti i treni Trenitalia e Italo
- Frequenza aggiornamento: ogni 1-3 minuti
- Copertura: Italia intera

## Optional

- [Note Legali e Disclaimer](https://treniamo.it/it/legal): Informazioni su fonti dati e limitazioni
- [Contatti](mailto:info@treniamo.it): Per domande e segnalazioni

---

## URL Structure & Navigation

### Station URLs
Format: /[locale]/stazione/[id-slug-name]
Examples:
- /it/stazione/S08409-roma-termini
- /en/stazione/S01700-milano-centrale

ID Format: S##### (Viaggiatreno RTVT format)
Query Parameters: tab=departures|arrivals (default: departures)

### Train URLs
Format: /[locale]/treno/[number-origin-destination]
Examples:
- /it/treno/9632-roma-termini-milano-centrale
- /en/treno/FR9632

Query Parameters: date=YYYY-MM-DD (default: today)

### Search Pages
Train Search: /[locale]/treno?q=[number]
Station Search: /[locale]/stazione?q=[name]

### Punctuality Statistics
Route Stats: /[locale]/puntualita/tratta/[origin-slug]-[origin-id]-[dest-slug]-[dest-id]

---

## API Endpoints (Programmatic Access)

Base URL: https://treniamo.it/api

All endpoints return JSON with proper caching headers (30s TTL, 15s stale-while-revalidate).

### Train Status
GET /v1/trains/[OPERATOR]:[number]/status?date=YYYY-MM-DD


Note: Train ID accepts both "TREN:9400" and "9400" formats (operator prefix optional)
Example: /v1/trains/TREN:9400/status

Response:
```json
{
  "train": {
    "id": "TREN:9400",
    "operatorId": "TREN",
    "trainNumber": "9400",
    "category": "FR"
  },
  "run": {
    "id": "TREN:9400:2026-02-08",
    "runDate": "2026-02-08",
    "originStationId": "S08409",
    "destinationStationId": "S02593",
    "status": "arrived",
    "currentDelay": 1
  },
  "stops": [
    {
      "stationId": "S08409",
      "stationName": "ROMA TERMINI",
      "scheduledDeparture": "2026-02-08T04:35:00.000Z",
      "actualDeparture": "2026-02-08T04:35:00.000Z",
      "scheduledPlatform": "5",
      "actualPlatform": "6",
      "delayDeparture": 0,
      "status": "departed"
    }
  ]
}
```

### Station Departures
GET /v1/stations/[id]/departures?limit=20

Example: /v1/stations/S08409/departures?limit=5

Response:
```json
{
  "station": {
    "id": "S08409",
    "name": "ROMA TERMINI"
  },
  "departures": [
    {
      "trainNumber": "9632",
      "destination": "MILANO CENTRALE",
      "scheduledDeparture": "2026-02-08T10:45:00.000Z",
      "platform": "12",
      "delay": 5,
      "status": "delayed"
    }
  ]
}
```

### Station Arrivals
GET /v1/stations/[id]/arrivals?limit=20

Example: /v1/stations/S08409/arrivals?limit=5

Response: Same structure as departures, with "arrivals" array.

### Station Autocomplete
GET /v1/stations/autocomplete?q=[query]

Example: /v1/stations/autocomplete?q=roma

Response:
```json
[
  {
    "id": "S08409",
    "name": "ROMA TERMINI",
    "region": "Lazio"
  },
  {
    "id": "S08217",
    "name": "ROMA TIBURTINA",
    "region": "Lazio"
  }
]
```

### All Stations (JSON)
GET /v1/stations/list?limit=100&offset=0

Example: /v1/stations/list?limit=10

Response:
```json
{
  "total": 2024,
  "limit": 10,
  "offset": 0,
  "stations": [
    {
      "id": "S05043",
      "name": "BOLOGNA CENTRALE",
      "lat": 44.506260,
      "lon": 11.342267
    }
  ]
}
```

---

## Data Formats

Station IDs: S##### (e.g., S08409 for Roma Termini)
Train IDs: [OPERATOR]:[number] (e.g., TREN:9632)
Operators: TREN (Trenitalia), ITALO, TRENORD
Timestamps: ISO 8601 format (UTC)
Delays: Minutes (integer)

## Full Station Dataset

GET /llms-full.txt (2024 stations with coordinates in pipe-separated format)
GET /api/v1/stations/list (JSON format with pagination)