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.co/api/v1/incidents?departamento=meta&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.co/api/v1/incidents?departamento=meta&source=invias&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: cierres totales, pasos a un carril y restringidos, derrumbes y accidentes del #767; alertas del IDEAM por lluvias, deslizamientos y crecientes; y focos de calor detectados por satélite. Llegan a través de la API de Roadscore y se leen cada minuto.

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

Parámetros

Ejemplo de petición y respuesta en JSON

https://traficoahora.co/api/v1/incidents?departamento=meta&source=invias&format=json

{
  "attribution": { "text": "Datos: Tráfico Ahora", "url": "https://traficoahora.co" },
  "count": 1,
  "incidents": [
    {
      "id": "invias-…",
      "type": "closure",
      "severity": "medium",
      "status": "active",
      "lat": 4.0712,
      "lon": -73.4851,
      "title": "Paso a un Carril · Villavicencio - Puerto López · PR 12+300",
      "description": "Paso a un carril por obras en la vía Villavicencio - Puerto López.",
      "source": "invias",
      "sourceName": "INVÍAS · Línea #767",
      "road": "Villavicencio - Puerto López",
      "departamento": "Meta",
      "departamentos": ["Meta"],
      "cause": "roadworks",
      "kmFrom": 12.3,
      "kmTo": 12.8,
      "prFrom": "PR 12+300",
      "prTo": "PR 12+800",
      "closure": "partial",
      "startedAt": "2026-10-09T13:00:00.000Z",
      "updatedAt": "2026-10-10T11:40:00.000Z",
      "district": "Meta"
    }
  ]
}

En GeoJSON, una alerta del IDEAM

https://traficoahora.co/api/v1/incidents?departamento=meta&source=wmo

{
  "attribution": { "text": "Datos: Tráfico Ahora", "url": "https://traficoahora.co" },
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "id": "wmo-…",
      "geometry": { "type": "Point", "coordinates": [-73.69, 3.99] },
      "properties": {
        "id": "wmo-…",
        "type": "weather",
        "severity": "high",
        "status": "active",
        "title": "Alerta por deslizamientos · Meta, Cundinamarca",
        "description": "Municipios en alerta. Meta: Acacías, Guamal. Cundinamarca: Guayabetal.",
        "source": "wmo",
        "sourceName": "IDEAM (vía OMM)",
        "sourceUrl": "https://www.pronosticosyalertas.gov.co/",
        "departamento": "Meta",
        "departamentos": ["Meta", "Cundinamarca"],
        "municipios": "Meta: Acacías, Guamal. Cundinamarca: Guayabetal",
        "startedAt": "2026-10-10T05:00:00.000Z",
        "updatedAt": "2026-10-10T05:00:00.000Z",
        "district": "Meta"
      }
    }
  ]
}

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.co/api/v1/incidents?debug=1

{
  "attribution": { "text": "Datos: Tráfico Ahora", "url": "https://traficoahora.co" },
  "generatedAt": "2026-10-10T12:00:00.000Z",
  "liveCount": 214,
  "totalCount": 214,
  "sources": [
    {
      "name": "invias",
      "configured": true,
      "ok": true,
      "count": 151,
      "newestAt": "2026-10-10T11:40:00.000Z",
      "stale": false,
      "byType": { "closure": 120, "traffic": 27, "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.co/api-publica (funciona 5 días) o pide un plan de pago a [email protected].",
  "clave": "https://traficoahora.co/api-publica",
  "contacto": "[email protected]",
  "atribucion": "La atribución es obligatoria en todos los planes: ...",
  "attribution": { "text": "Datos: Tráfico Ahora", "url": "https://traficoahora.co" }
}

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.co/api-publica",
  "contacto": "[email protected]",
  "atribucion": "La atribución es obligatoria en todos los planes: ...",
  "attribution": { "text": "Datos: Tráfico Ahora", "url": "https://traficoahora.co" }
}

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 (INVÍAS · Línea #767, IDEAM (vía OMM) y NASA FIRMS), no son nuestros y no los licenciamos. El INVÍAS no declara una licencia para el #767; lo citamos siempre y le hemos pedido que confirme 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 colombianos (COP), con factura.

Condiciones y atribución

Datos: <a href="https://traficoahora.co">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 INVÍAS (Línea #767, con la Policía de Tránsito), del IDEAM y de NASA FIRMS. Quien los lee tiene derecho a saber que un cierre 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 vía. Una vía sin eventos en la respuesta no es una vía despejada: es una vía sobre la que nadie ha publicado nada. El #767 se centra en la red vial nacional; las vías departamentales y municipales tienen menos cobertura, y el tráfico 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, 123.

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.