La API de Tráfico Ahora

Empezar

Crea una clave de prueba en el formulario de abajo y añádela a la petición. Abre esto en el navegador, con tu clave al final, y ya tienes datos:

https://traficoahora.cl/api/v1/incidents?region=biobio&key=tes_…

Devuelve GeoJSON, listo para un mapa. Para JSON simple, añade &format=json. En un programa, mejor la clave en la cabecera:

curl -H "X-API-Key: tes_…" "https://traficoahora.cl/api/v1/incidents?region=biobio&source=mop-cl&format=json"

La clave

La API es de pago y cada petición lleva clave. La clave que se crea aquí es de prueba: funciona 5 días desde la primera petición, con 120 peticiones por hora, para comprobar si la API sirve para lo que estás construyendo. Para seguir después, escribe a [email protected] con el nombre del proyecto y el uso previsto, y te respondemos con el plan y la factura.

Pedimos nombre, correo y para qué la quieres por tres razones concretas: para avisarte cuando una fuente deje de publicar o cambie de formato; para saber qué le falta a la API a quien la usa en serio; y porque una clave que se puede revocar protege a todos de un bucle descontrolado.

La clave va en la cabecera X-API-Key, en Authorization: Bearer … o en el parámetro key. Sin clave, la API responde 401.

Eventos activos: /api/v1/incidents

Todo lo que publican ahora mismo las fuentes: cortes de camino totales, tránsito por una pista o restringido, derrumbes y accidentes del MOP; avisos de la Dirección Meteorológica por lluvias, viento, nevadas y marejadas; y focos de calor detectados por satélite. Llegan a través de la API de Roadscore y se leen cada minuto. Las capas del MOP mezclan dos años de historia con lo de hoy; Roadscore se queda sólo con lo que restringe el tránsito y se ha tocado hace poco.

GET https://traficoahora.cl/api/v1/incidents

Parámetros

Ejemplo de petición y respuesta en JSON

https://traficoahora.cl/api/v1/incidents?region=biobio&source=mop-cl&format=json

{
  "attribution": { "text": "Datos: Tráfico Ahora", "url": "https://traficoahora.cl" },
  "count": 1,
  "incidents": [
    {
      "id": "mop-cl-…",
      "type": "closure",
      "severity": "medium",
      "status": "active",
      "lat": -37.5312,
      "lon": -72.2405,
      "title": "Tránsito restringido · Ruta Q-45 · km 12,3",
      "description": "Parcialmente operativo: tránsito por media calzada por obras de conservación.",
      "source": "mop-cl",
      "sourceName": "MOP · Dirección de Vialidad",
      "road": "Q-45",
      "region": "Biobío",
      "regiones": ["Biobío"],
      "cause": "roadworks",
      "kmFrom": 12.3,
      "kmTo": 12.8,
      "closure": "partial",
      "startedAt": "2026-10-09T13:00:00.000Z",
      "updatedAt": "2026-10-10T11:40:00.000Z",
      "district": "Biobío"
    }
  ]
}

En GeoJSON, un aviso de la Dirección Meteorológica

https://traficoahora.cl/api/v1/incidents?region=maule&source=wmo

{
  "attribution": { "text": "Datos: Tráfico Ahora", "url": "https://traficoahora.cl" },
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "id": "wmo-…",
      "geometry": { "type": "Point", "coordinates": [-71.32, -35.82] },
      "properties": {
        "id": "wmo-…",
        "type": "weather",
        "severity": "high",
        "status": "active",
        "title": "Precipitaciones intensas · Maule, Ñuble",
        "description": "Aviso de precipitaciones intensas. Zonas: Maule: Cordillera. Ñuble: Cordillera.",
        "source": "wmo",
        "sourceName": "Dirección Meteorológica de Chile (vía OMM)",
        "sourceUrl": "https://www.meteochile.gob.cl/PortalDMC-web/index.xhtml",
        "region": "Maule",
        "regiones": ["Maule", "Ñuble"],
        "zonas": "Maule: Cordillera. Ñuble: Cordillera",
        "startedAt": "2026-10-10T05:00:00.000Z",
        "updatedAt": "2026-10-10T05:00:00.000Z",
        "district": "Maule"
      }
    }
  ]
}

Ejemplos ilustrativos, con la forma exacta de la respuesta y recortados a un evento. En GeoJSON los campos van en properties y las coordenadas en el orden de GeoJSON: longitud, latitud.

Campos de cada evento

Diagnóstico: ?debug=1

https://traficoahora.cl/api/v1/incidents?debug=1

{
  "attribution": { "text": "Datos: Tráfico Ahora", "url": "https://traficoahora.cl" },
  "generatedAt": "2026-10-10T12:00:00.000Z",
  "liveCount": 214,
  "totalCount": 214,
  "sources": [
    {
      "name": "mop-cl",
      "configured": true,
      "ok": true,
      "count": 151,
      "newestAt": "2026-10-10T11:40:00.000Z",
      "stale": false,
      "byType": { "closure": 132, "traffic": 15, "accident": 4 }
    }
  ]
}

Útil cuando un número parece raro: dice qué fuente está callada. El ejemplo está recortado a una fuente.

Códigos de respuesta

HTTP/1.1 401 Unauthorized
{
  "error": "Clave necesaria",
  "detail": "La API de Tráfico Ahora ya no responde sin clave. Crea una clave de prueba en https://traficoahora.cl/api-publica (funciona 5 días) o pide un plan de pago a [email protected].",
  "clave": "https://traficoahora.cl/api-publica",
  "contacto": "[email protected]",
  "atribucion": "La atribución es obligatoria en todos los planes: ...",
  "attribution": { "text": "Datos: Tráfico Ahora", "url": "https://traficoahora.cl" }
}

HTTP/1.1 402 Payment Required
{
  "error": "Periodo de prueba terminado",
  "detail": "Esta clave era de prueba y terminó el 15 de octubre de 2026. Para seguir usando la API, escribe a [email protected] ...",
  "planes": "https://traficoahora.cl/api-publica",
  "contacto": "[email protected]",
  "atribucion": "La atribución es obligatoria en todos los planes: ...",
  "attribution": { "text": "Datos: Tráfico Ahora", "url": "https://traficoahora.cl" }
}

Límites

La prueba admite 120 peticiones por hora. Los planes de pago se cuentan por día: 10.000 peticiones en Personal y 100.000 en Profesional; Empresa, lo que se acuerde. Se cuenta por clave y no por IP, para que una app con muchos usuarios no se frene por uno de ellos. Si te pasas, recibes un 429 con el tiempo de espera en Retry-After.

Las fuentes se leen cada minuto y la respuesta tiene caché de 30 segundos, así que pedir más de dos veces por minuto no trae ni un dato nuevo. Quien choca con el límite es, casi siempre, un bucle olvidado.

El CORS está abierto: puedes llamar directamente desde el navegador, sin servidor en medio. Ten en cuenta que la clave queda entonces a la vista de quien abra la página.

Planes y precios

Qué se paga: el acceso al servicio, es decir, la API en sí, los límites del plan y el soporte. No los datos: los eventos son de las entidades que los publican (MOP · Dirección de Vialidad, Dirección Meteorológica de Chile (vía OMM) y NASA FIRMS), no son nuestros y no los licenciamos. Ni el MOP ni la CNE declaran una licencia para sus datos; los citamos siempre y les hemos pedido por correo que confirmen la reutilización. Por eso cada registro conserva su fuente, y quien los muestra mantiene ese crédito.

Cómo se paga: por ahora, por correo y factura. Escribe a [email protected] con el nombre del proyecto, el uso previsto y el plan que te interesa, y te respondemos con la factura. Al pagar, tu clave de prueba pasa al plan y deja de vencerse. Precios por mes, en pesos chilenos (CLP), con factura.

Condiciones y atribución

Datos: <a href="https://traficoahora.cl">Tráfico Ahora</a>

• Construir un producto sobre la API sin plan de pago, una vez terminada la prueba, o sin atribución, no es un uso autorizado.
• La clave es personal del proyecto: no se comparte ni se publica. Si se filtra, escríbenos y emitimos otra.
• Una clave puede revocarse si se usa para algo distinto de lo declarado o sin atribución.
• Los datos son del MOP (Dirección de Vialidad), de la Dirección Meteorológica de Chile (vía OMM) y de NASA FIRMS. Quien los lee tiene derecho a saber que un corte de camino lo registró una entidad y no un algoritmo.
• Más detalles en los términos y, sobre los datos de quien tiene clave, en la política de tratamiento de datos.

Honestidad sobre la cobertura

Esta API devuelve lo que publican las fuentes, no lo que está pasando en la carretera. Una ruta sin eventos en la respuesta no es una ruta despejada: es una ruta sobre la que nadie ha publicado nada. Las autopistas concesionadas (la Ruta 5, la Ruta 68, las autopistas urbanas de Santiago) casi nunca aparecen en las capas del MOP, y el tránsito urbano no está.

Si construyes avisos encima de esto, díselo a quien los recibe. Y no la uses para decisiones de emergencia: en una emergencia, 133.

El estado de cada fuente, en directo, está en ?debug=1; de dónde sale cada una, en Qué es Tráfico Ahora.

Contacto

Para planes de pago, volumen, facturas, una clave perdida o cualquier duda sobre la API: [email protected]. Respondemos nosotros, no un sistema de tickets. Si buscas datos de varios países o un acuerdo con SLA, mira Roadscore.