BonoVía
GET/v1/exploreRequiere X-API-Key

Explorar destinos alcanzables

Todos los destinos alcanzables desde una estación de origen, en trayecto directo, con duración y operador. Paginado.

Parámetros

NombreEnTipoRequeridoDescripción
fromquerystringrequeridostop_id de origen.
datequerystringopcionalDD-MM-YYYY (o ISO YYYY-MM-DD). Por defecto, hoy.
maxTimequeryintegeropcionalDuración máxima del trayecto en minutos. Por defecto, 360.
pagequeryintegeropcionalPágina, 1-indexada. Por defecto, 1.
perPagequeryintegeropcionalDestinos por página. Por defecto, 200. Máximo, 500.

Ejemplo

Request
curl "https://api.bonovia.app/v1/explore?from=cluster_madrid&date=24-09-2026&maxTime=180&page=1" \
  -H "X-API-Key: tu_key_aqui"
Response
{
  "origin": "cluster_madrid",
  "origin_lat": 40.449,
  "origin_lon": -3.643,
  "date": "2026-09-24",
  "max_time_minutes": 180,
  "destinations": [
    { "stop_id": "...", "stop_name": "...", "duration_minutes": 45, "mode": "train" }
  ],
  "count": 200,
  "page": 1,
  "per_page": 200,
  "total": 743,
  "total_pages": 4,
  "precomputed": true
}