Documentación API v1

API de Inteligencia de Tráfico

La API de tráfico más completa de España. 121 endpoints, datos en tiempo real e históricos sobre tráfico, combustible, ferrocarril, meteorología, movilidad y seguridad vial.

121

Endpoints

60 s

Actualización incidencias

Colecciones Typesense

REST

JSON · GeoJSON

Planes de acceso

Empieza gratis, escala cuando lo necesites.

FREE

0€

10 req/min·1000 req/día

Incidencias en tiempo real
Precios de combustible
Alertas meteorológicas
Alertas ferroviarias
Búsqueda multi-colección
JSON estándar

Empezar gratis

Más popular

PRO

29€/mes

60 req/min·50.000 req/día

Todo lo del plan FREE
Datos históricos completos
Análisis de tendencias
Movilidad O/D
Microdatos de accidentes
Datos climáticos
Seguimiento de flota
Predicciones y forecasts

Obtener PRO

ENTERPRISE

149€/mes

300 req/min·500.000 req/día

Todo lo del plan PRO
Exportación masiva
Webhooks push
Soporte prioritario
SLA 99,9% uptime
IP dedicada
Factura mensual

Contactar ventas

Autenticación

Todas las peticiones a la API requieren el header X-API-Key con tu clave personal. Siempre por HTTPS.

curl -H "X-API-Key: tl_free_tu_clave_aqui" \
     https://trafico.live/api/incidents

Las peticiones sin API key están sujetas a límites de IP muy estrictos. Para cualquier uso en producción, utiliza siempre una clave de API.

Endpoints disponibles

121 endpoints agrupados por dominio. Los endpoints marcados PRO o ENT requieren plan de pago.

Tráfico en tiempo real5 endpoints

GET

/api/incidents

Incidencias activas en España: accidentes, obras, retenciones. Fuente DGT DATEX II, actualización cada 60 s.

FREE

GET

/api/trafico/intensidad

Intensidad de tráfico en tiempo real: 6.117 sensores de Madrid, veh/h, ocupación, nivel de servicio.

FREE

GET

/api/trafico/prediccion

Predicción de tráfico: heatmap horario, comparativa histórica y forecast a 4 h por corredor.

PRO

GET

/api/v16

Balizas V16 de emergencia activas con posición GPS en tiempo real.

FREE

GET

/api/panels

Paneles de mensaje variable (PMV) en carreteras de acceso a Madrid.

FREE

Combustible4 endpoints

GET

/api/gas-stations

Gasolineras con precios por tipo de combustible, operador y coordenadas. Más de 11.000 estaciones.

FREE

GET

/api/combustible/historico

Serie histórica de precios medios nacionales por tipo de combustible. Semanal desde 2019.

PRO

GET

/api/combustible/tendencia

Tendencia y variación semanal de precios. Útil para alertas de precio.

PRO

GET

/api/prediccion/combustible

Predicción de precio de combustible a 7 días basada en modelo de series temporales.

PRO

Ferrocarril4 endpoints

GET

/api/trenes/estaciones

Catálogo de estaciones ferroviarias (Cercanías + AVE + LD). Coordenadas, nombre ADIF, líneas.

FREE

GET

/api/trenes/rutas

Rutas ferroviarias con geometría GeoJSON. Cercanías, AVE y Larga Distancia.

FREE

GET

/api/trenes/alertas

Alertas de servicio Renfe en tiempo real: cancelaciones, retrasos >5 min. Cadencia 2 min.

FREE

GET

/api/trenes/flota

Flota de material rodante por línea: tipo, capacidad, accesibilidad.

PRO

Meteorología3 endpoints

GET

/api/weather

Condiciones meteorológicas relevantes para la conducción: viento, lluvia, nieve, niebla por carretera o provincia.

FREE

GET

/api/clima/historico

Serie histórica de condiciones meteorológicas por estación AEMET y carretera.

PRO

GET

/api/clima/estaciones

Catálogo de estaciones meteorológicas AEMET relevantes para vialidad.

FREE

Movilidad2 endpoints

GET

/api/movilidad

Matrices origen-destino y flujos de movilidad interprovincial. IMD histórico por carretera.

PRO

GET

/api/movilidad/corredores

Análisis de corredores: IMD, variación interanual y perfil horario típico.

PRO

Seguridad vial3 endpoints

GET

/api/accidentes/microdata

Microdatos de siniestralidad DGT: accidentes con víctimas desde 2015. Formato tidy CSV/JSON.

PRO

GET

/api/accidentes/hotspots

Puntos negros de siniestralidad calculados por densidad kernel. GeoJSON.

PRO

GET

/api/prediccion/riesgo

Predicción de riesgo de accidente por tramo y hora. Modelo ML sobre histórico DGT + AEMET.

ENTERPRISE

Marítimo2 endpoints

GET

/api/maritimo

Precios de combustible marítimo en puertos españoles. Gasoil marino, fuel-oil.

FREE

GET

/api/maritimo/ferries

Rutas de ferry activas con frecuencias y operadores.

FREE

Aviación2 endpoints

GET

/api/aviacion

Demoras y cancelaciones en aeropuertos españoles AENA. Actualización horaria.

PRO

GET

/api/aviacion/aeropuertos

Catálogo de aeropuertos con estadísticas de puntualidad y tráfico.

PRO

Búsqueda1 endpoint

GET

/api/search

Búsqueda full-text sobre 14 colecciones: gasolineras, carreteras, cámaras, municipios, ZBE, estaciones, radares…

FREE

Ejemplos de código

Obtén incidencias activas en Madrid en tres líneas.

cURL

curl -s \
  -H "X-API-Key: tl_free_tu_clave_aqui" \
  "https://trafico.live/api/incidents?province=Madrid"

JavaScript / TypeScript

const res = await fetch(
  "https://trafico.live/api/incidents?province=Madrid",
  { headers: { "X-API-Key": "tl_free_tu_clave_aqui" } }
);
const { total, incidents } = await res.json();
console.log(`${total} incidencias activas en Madrid`);

Python

import httpx

resp = httpx.get(
    "https://trafico.live/api/incidents",
    params={"province": "Madrid"},
    headers={"X-API-Key": "tl_free_tu_clave_aqui"},
)
data = resp.json()
print(f"{data['total']} incidencias activas")

Respuesta JSON

{
  "total": 12,
  "updated_at": "2026-04-02T11:15:00Z",
  "incidents": [
    {
      "id": "SP_INC_20260402_0041",
      "type": "ACCIDENT",
      "road": "A-4",
      "km": 28.3,
      "province": "Madrid",
      "severity": "HIGH",
      "description": "Accidente con retención sentido Córdoba",
      "delay_minutes": 22,
      "lat": 40.3456,
      "lon": -3.7632,
      "created_at": "2026-04-02T10:47:00Z"
    }
  ]
}

MCP Server para IA

Conecta Claude, Cursor u otro asistente compatible con MCP directamente a datos de tráfico en tiempo real.

Model Context Protocol

El MCP Server de trafico.live expone herramientas para que modelos de lenguaje puedan consultar incidencias, precios de combustible, trenes y más, sin salir de su contexto. Soporta Claude Desktop, Cursor y cualquier cliente MCP.

Configuración — claude_desktop_config.json

{
  "mcpServers": {
    "trafico-live": {
      "command": "npx",
      "args": ["-y", "@trafico-live/mcp-server"],
      "env": {
        "TRAFICO_API_KEY": "tl_free_tu_clave_aqui"
      }
    }
  }
}

Herramientas disponibles

60 s

Cadencia mínima

MCP 1.0

Protocolo

Obtén tu API Key

Sin tarjeta de crédito. Tu clave FREE está lista en segundos.

Preguntas frecuentes

¿Cómo obtengo una API key para trafico.live?

Rellena el formulario con tu email en esta página. Recibirás una clave FREE al instante, sin tarjeta de crédito. El plan FREE incluye 10 req/min y 1.000 req/día.

¿Con qué frecuencia se actualizan los datos?

Las incidencias de tráfico se actualizan cada 60 segundos desde el NAP de la DGT. La intensidad de tráfico de Madrid se refresca cada 5 minutos. Los precios de combustible varias veces al día. Las alertas de Renfe cada 2 minutos.

¿Qué es el MCP server de trafico.live?

El MCP (Model Context Protocol) server permite que asistentes de IA como Claude accedan directamente a datos de tráfico en tiempo real. Se configura en segundos en Claude Desktop o cualquier cliente compatible con MCP.

¿Cuál es el formato de los datos?

Todos los endpoints devuelven JSON con codificación UTF-8. Las fechas siguen ISO 8601 (UTC). Las coordenadas usan WGS84. Algunos endpoints de geometría devuelven GeoJSON.

Empieza a construir hoy

Plan FREE sin tarjeta, 1.000 peticiones al día. Escala a PRO (29€/mes) cuando tu proyecto crezca.

Obtener API Key gratis Contactar ventas