En vivo — acceso por clave, emitida a mano

Los horarios de TUSSAM en Sevilla, listos para tu app

La misma base que usa Busillo para calcular horarios — líneas, paradas y avisos de TUSSAM ya simplificados y documentados, sin que tengas que parsear el feed GTFS tú mismo. Gratis para lo estático. Los tiempos en vivo todavía no están resueltos — lee por qué más abajo.

Pide tu clave de API → Ver los endpoints

Endpoints

Cuatro grupos de datos, todos bajo https://devsapi.busillo.app. Los tres primeros están en vivo hoy — ya son datos abiertos de TUSSAM (GTFS, licencia MITRAMS), esto solo los sirve ya parseados y documentados. El cuarto, los tiempos en vivo, existe como ruta pero todavía no da datos — lee por qué en su propia sección.

Líneas

Catálogo de líneas y horario programado por línea

Gratis · en vivo

GET/v1/lineas

GET/v1/lineas/:id/horario

Ejemplo real de respuesta

GET https://devsapi.busillo.app/v1/lineas/01/horario
X-API-Key: bsl_...

{
  "id": "01",
  "nombre": "Plg. Norte H. Virgen del Rocio",
  "sentido": "HOSPITAL V.ROCIO",
  "primera_parada": "San Lázaro Av (Dr. Morote)",
  "salidas_laborable": ["05:54", "06:00", "06:25", …],
  "atribucion": "Datos GTFS de TUSSAM, distribuidos vía NAP — MITRAMS"
}

Paradas

Catálogo de paradas de TUSSAM, deduplicado

Gratis · en vivo

GET/v1/paradas

GET/v1/paradas/:codigo

Avisos

Avisos activos de TUSSAM (cortes, desvíos, incidencias)

Gratis · en vivo

GET/v1/avisos

Tiempos en vivo

Estimación de llegada en tiempo real por parada

Pendiente

GET/v1/paradas/:codigo/tiempos

Por qué da 501 en vez de un dato: TUSSAM bloquea las peticiones desde IPs de datacenter, así que este endpoint no puede consultarles en directo. La única vía real que existe hoy en Busillo para datos en vivo es un relay — dispositivos con IP residencial que ya están consultando esa parada retransmiten el dato — lo que daría cobertura parcial, no "cualquier parada, en cualquier momento" como esperarías de un endpoint de pago. Antes de construir eso hace falta decidir si esa cobertura parcial es un producto honesto o si hay que buscar otra vía. Mientras tanto la ruta existe y responde 501 con una explicación, no un 404 silencioso. Cuando se resuelva será de pago — el resto de la API se queda gratis.

Autenticación con una clave de API en la cabecera X-API-Key o en ?key= — nada de OAuth. Límite de 60 peticiones/minuto por clave (429 si te pasas). Toda respuesta con datos del feed GTFS del NAP incluye un campo "atribucion" — tienes que mostrarlo tú también donde uses esos datos, es condición de la licencia, no un adorno.

Precios

El dinero se cobra donde está el trabajo real de mantenerlo — no en el dato que ya es abierto y gratuito para cualquiera.

Líneas · Paradas · Avisos

Gratis

60 peticiones/minuto por clave — límite de uso razonable, no pensado para bloquear un uso normal

Catálogo completo de líneas y paradas
Horario programado (GTFS)
Avisos activos de TUSSAM

+ Tiempos en vivo

5-15 € /mes

Orientativo, precio final por confirmar — y todavía no hay nada que cobrar: el endpoint no está resuelto (ver arriba)

Todo lo del plan gratis
Estimaciones de llegada en tiempo real por parada
Una sola clave de API

El acceso es manual, por ahora

La API ya funciona, pero las claves se emiten a mano — sin auto-registro ni cobro automatizado todavía. Escríbenos y te damos una en cuanto veamos el mensaje.

Pide tu clave de API →