GET/v1/stationsRequiere X-API-Key

Buscar estaciones

Búsqueda de estaciones y agrupaciones de ciudad por nombre, sin distinguir acentos ni mayúsculas.

Parámetros

Nombre	En	Tipo	Requerido	Descripción
q	query	string	requerido	Texto de búsqueda, mínimo 2 caracteres.

Ejemplo

Request

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

Response

{
  "stations": [
    {
      "stop_id": "18000",
      "stop_name": "Madrid-Atocha Cercanías",
      "stop_lat": 40.4066191,
      "stop_lon": -3.6894391,
      "operators": [
        { "operator": "renfe", "mode": "train", "services": ["LD", "AVLO", "MD"] }
      ]
    }
  ],
  "count": 1
}

Los resultados pueden incluir un is_cluster: true — una agrupación de todas las estaciones de una misma ciudad, no una estación física concreta.

Errores posibles de este endpoint

400

El parámetro q falta o tiene menos de 2 caracteres.

{ "error": "Query must be at least 2 characters" }

401

Falta la cabecera X-API-Key, o la key no es válida, ha sido revocada, o ha expirado.

{ "error": "Missing or invalid X-API-Key" }

429

Superaste el límite de peticiones (60/min por key, o el respaldo por IP).

{ "error": "Too many requests" }

Formato general de errores →