ULTRACYCLINGHUB.
ESIdioma
Menú
Mi temporada 0

Para desarrolladores y agentes de IA

LOS DATOS,
ABIERTOS.

Los mismos datos con fuentes que ven los ciclistas, listos para tus herramientas. Lee eventos publicados, ediciones aprobadas y sus fuentes en JSON o Markdown.

Abrir el esquema de la API

Empieza aquí

HAZ TU PRIMERA PETICIÓN.

No se necesita clave de API. El acceso es de solo lectura y las respuestas pueden leerse desde cualquier origen. Mantén un número de peticiones moderado. Los registros están en inglés, sea cual sea el idioma de esta página.

Ejemplo · próximas ediciones de carretera

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

La respuesta incluye results, el total count y una URL next para la página siguiente.

Ver esta respuesta JSON

REFERENCIA DE ENDPOINTS.

Usa los filtros del directorio para encontrar ediciones y luego lee un evento completo o una sola edición. El esquema documenta los campos y filtros disponibles.

GET/api/editions.json

Buscar ediciones

Busca con los filtros del directorio. Pagina con page y limit, hasta 100 registros por página. Un filtro no válido devuelve HTTP 400 con los errores de cada campo.

GET/api/openapi.json

Esquema de la API

La descripción OpenAPI de los endpoints de búsqueda y de registros.

GET/events/<slug>.json

Un evento

Lee un evento con todas sus ediciones aprobadas y sus fuentes. Sustituye .json por .md para obtener Markdown.

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

Una edición

Usa el id de registro de la edición, junto con el slug del evento y el año. La URL de datos incluye este ID aunque la página HTML no lo haga. El Markdown también está disponible en .md.

GET/changes.atom

Cambios en datos publicados

Un feed Atom de las correcciones de los datos publicados.

¿Prefieres Markdown desde una URL HTML de un evento o edición? Envía la cabecera Accept: text/markdown.

PARA AGENTES DE IA.

Conectar por MCP

El servidor HTTP sin estado acepta peticiones POST y ofrece dos herramientas de solo lectura: search_events y get_event.

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

Reglas de lectura y cobertura

Empieza por las convenciones de los datos, las pautas para citarlos y la cobertura actual.

/llms-full.txt

La colección completa

Las mismas reglas de lectura, seguidas de cada evento publicado en Markdown.

USA LOS DATOS CON CUIDADO.

Conserva la procedencia
Cada registro incluye su source_url y su fecha verified_on. Un valor que falta significa que no está verificado, nunca cero ni ausente.
Cita la fuente
Los datos tienen licencia CC BY 4.0. Enlaza la página del evento o de la edición, nombra «Ultracycling Hub» e indica la fecha de verificación del registro.
Confirma antes de inscribirte
Los detalles de inscripción, precios y fechas cambian. Envía a los ciclistas a la organización para inscribirse. Lee cómo se verifican las fichas.
Informar de un problema en los datos