API pública

API para desarrolladores

Estaciones, destinos alcanzables y salidas de transporte de toda España, derivados de feeds GTFS oficiales. Consulta la documentación completa o la especificación OpenAPI.

Gratis y al instante

Sin registro real, sin aprobación manual, sin plan de pago.

REST y MCP

La misma base de datos GTFS, expuesta como API REST y como servidor MCP.

Uso permisivo

Comercial o no comercial — todo lo que las licencias de los datos permiten.

Consigue tu API key

Gratis, al instante, sin más pasos que este formulario.

El email es opcional — solo lo usamos para poder contactarte si detectamos un problema con tu key. Límite: 5 keys por hora por IP.

Quickstart

Cada endpoint (salvo la propia alta) requiere tu key en la cabecera X-API-Key.

curl "https://api.bonovia.app/v1/stations?q=madrid" \
  -H "X-API-Key: tu_key_aqui"

Endpoints

POST/v1/keyssin auth

Crear una API key (self-service, este formulario hace exactamente esto).

GET/v1/stations

Buscar estaciones por nombre (?q=madrid).

GET/v1/explore

Destinos alcanzables desde una estación, paginado (?from=..., ?date=DD-MM-YYYY, ?maxTime=..., ?page=..., ?perPage=...).

GET/v1/departures

Próximas salidas desde una estación (?from=..., ?limit=...).

GET/v1/health

Frescura de los datos GTFS.

GET/v1/keys/usage

Estadísticas de uso de tu propia key.

Límites

60 peticiones/minuto por key.
5 keys nuevas/hora por dirección IP.
Respuesta 429 con cabecera Retry-After si te pasas.

Licencia y términos

BonoVía es código abierto y actúa como middleware sobre datos GTFS oficiales: puedes usar esta API con fines comerciales o no comerciales, todo lo que las licencias originales permiten.

Términos de uso de la API →Atribución de datos →