Per sviluppatori e agenti IA

I DATI,
APERTI.

Gli stessi dati con fonti che vedono i ciclisti, pronti per i tuoi strumenti. Leggi eventi pubblicati, edizioni approvate e le loro fonti in JSON o Markdown.

Apri lo schema dell’API

Inizia da qui

FAI LA TUA PRIMA RICHIESTA.

Non serve una chiave API. L’accesso è in sola lettura e le risposte possono essere lette da qualsiasi origine. Mantieni le richieste moderate. I record sono in inglese, qualunque sia la lingua di questa pagina.

Esempio · prossime edizioni su strada

curl "https://ultracyclinghub.com/api/editions.json?discipline=road&period=upcoming&limit=3"

La risposta include results, il totale count e un URL next per la pagina successiva.

Vedi questa risposta JSON

RIFERIMENTO DEGLI ENDPOINT.

Usa i filtri dell’elenco per trovare le edizioni, poi leggi un evento completo o una singola edizione. Lo schema documenta campi e filtri disponibili.

GET/api/editions.json

Cerca edizioni

Cerca con i filtri dell’elenco. Pagina con page e limit, fino a 100 record per pagina. Un filtro non valido restituisce HTTP 400 con gli errori dei campi.

GET/api/openapi.json

Schema dell’API

La descrizione OpenAPI degli endpoint di ricerca e dei record.

GET/events/<slug>.json

Un evento

Leggi un evento con tutte le sue edizioni approvate e le fonti. Sostituisci .json con .md per il Markdown.

GET/events/<slug>/<year>/<id>.json

Un’edizione

Usa l’id del record dell’edizione, insieme allo slug dell’evento e all’anno. L’URL dei dati include questo ID anche quando la pagina HTML non lo fa. Il Markdown è disponibile anche in .md.

GET/changes.atom

Modifiche ai dati pubblicati

Un feed Atom delle correzioni ai dati pubblicati.

Preferisci il Markdown da un URL HTML di un evento o di un’edizione? Invia l’intestazione Accept: text/markdown.

PER AGENTI IA.

Collegati tramite MCP

Il server HTTP senza stato accetta richieste POST e offre due strumenti in sola lettura: search_events e get_event.

URL del serverhttps://ultracyclinghub.com/mcp/
/llms.txt

Regole di lettura e copertura

Inizia dalle convenzioni dei dati, dalle indicazioni per citarli e dalla copertura attuale.

/llms-full.txt

La raccolta completa

Le stesse regole di lettura, seguite da ogni evento pubblicato in Markdown.

USA I DATI CON CURA.

Conserva la provenienza
Ogni record riporta la sua source_url e la data verified_on. Un valore mancante significa non verificato, mai zero o assente.
Cita la fonte
I dati sono rilasciati con licenza CC BY 4.0. Inserisci un link alla pagina dell’evento o dell’edizione, cita «Ultracycling Hub» e indica la data di verifica del record.
Conferma prima di iscriverti
Dettagli di iscrizione, prezzi e date cambiano. Manda i ciclisti dall’organizzatore per iscriversi. Leggi come vengono verificate le schede.
Segnala un problema nei dati