API v1

Precios de combustible de Colombia

Estaciones, precio por galón y la confianza de cada dato, listos para integrar en tu producto. Para pedir una llave de prueba escribe a contacto@mokev.net.

Descargar la propuesta para empresas (PDF)

Autenticación

Envía tu llave en el encabezado Authorization: Bearer tnq_live_… (o X-API-Key). Úsala solo desde tu servidor. Cada llave tiene un límite de peticiones por minuto, que verás en los encabezados X-RateLimit-Limit y X-RateLimit-Remaining.

Endpoints

GET/api/v1/stations/nearby
Estaciones cerca de un punto, con su precio vigente. Parámetros: lat, lng, radius_m (100–50000), fuel (corriente, extra, acpm, gas), limit (1–200).
GET/api/v1/stations/{id}
Una estación con el precio de cada combustible que vende y si está verificada por su administrador.
GET/api/v1/cities/{slug}/prices
Promedio y rango de la comunidad por ciudad, junto con la referencia oficial de SICOM y el máximo regulado.

Ejemplo

curl "https://tanqueo.com.co/api/v1/stations/nearby?lat=2.9273&lng=-75.2819&radius_m=3000&fuel=corriente&limit=5" \
  -H "Authorization: Bearer tnq_live_XXXXXXXX"

{
  "data": [{
    "id": "7c1e…",
    "name": "Primax",
    "brand": "Primax",
    "address": "Cra. 5 #…",
    "city": "Neiva",
    "location": { "lat": 2.9301, "lng": -75.2874 },
    "distance_m": 540,
    "verified": false,
    "fuel": "corriente",
    "price": {
      "amount": 15850, "currency": "COP", "unit": "gallon",
      "status": "confirmado", "confidence": 82, "reports": 4,
      "updated_at": "2026-11-03T14:20:00Z"
    },
    "last_known_price": null,
    "city_reference": { "amount": 16224, "currency": "COP", "source": "SICOM", "date": "2026-11-01" }
  }],
  "meta": { "count": 1, "radius_m": 3000, "fuel": "corriente" }
}

Cómo leer un precio

price: precio vigente (reportes de las últimas ~60 horas, ponderados por la reputación de quien reporta). status es «estimado» o «confirmado» (2 o más personas distintas).
last_known_price: último precio reportado cuando el vigente venció (hasta 14 días). Úsalo como dato histórico, no como precio actual.
city_reference: promedio oficial de la ciudad que publica SICOM (Ministerio de Minas y Energía). No es el precio de esa estación.
verified: el administrador de la estación verificó su cuenta y mantiene el precio.

Errores

Las respuestas de error tienen la forma { "error": { "code": "…", "message": "…" } }. Códigos: missing_key y invalid_key (401), invalid_params (400), not_found (404), rate_limited (429).

Los precios los reporta la comunidad y se contrastan con SICOM; son una referencia y pueden cambiar sin aviso. Tanqueo no garantiza el precio que cobre una estación.

Endpoints

GET/api/v1/stations/nearby

Estaciones cerca de un punto, con su precio vigente. Parámetros: lat, lng, radius_m (100–50000), fuel (corriente, extra, acpm, gas), limit (1–200).

GET/api/v1/stations/{id}

Una estación con el precio de cada combustible que vende y si está verificada por su administrador.

GET/api/v1/cities/{slug}/prices

Promedio y rango de la comunidad por ciudad, junto con la referencia oficial de SICOM y el máximo regulado.

Ejemplo

curl "https://tanqueo.com.co/api/v1/stations/nearby?lat=2.9273&lng=-75.2819&radius_m=3000&fuel=corriente&limit=5" \ -H "Authorization: Bearer tnq_live_XXXXXXXX"

{ "data": [{ "id": "7c1e…", "name": "Primax", "brand": "Primax", "address": "Cra. 5 #…", "city": "Neiva", "location": { "lat": 2.9301, "lng": -75.2874 }, "distance_m": 540, "verified": false, "fuel": "corriente", "price": { "amount": 15850, "currency": "COP", "unit": "gallon", "status": "confirmado", "confidence": 82, "reports": 4, "updated_at": "2026-11-03T14:20:00Z" }, "last_known_price": null, "city_reference": { "amount": 16224, "currency": "COP", "source": "SICOM", "date": "2026-11-01" } }], "meta": { "count": 1, "radius_m": 3000, "fuel": "corriente" } }

Cómo leer un precio

price: precio vigente (reportes de las últimas ~60 horas, ponderados por la reputación de quien reporta). status es «estimado» o «confirmado» (2 o más personas distintas).

last_known_price: último precio reportado cuando el vigente venció (hasta 14 días). Úsalo como dato histórico, no como precio actual.

city_reference: promedio oficial de la ciudad que publica SICOM (Ministerio de Minas y Energía). No es el precio de esa estación.

verified: el administrador de la estación verificó su cuenta y mantiene el precio.

Errores

Los precios los reporta la comunidad y se contrastan con SICOM; son una referencia y pueden cambiar sin aviso. Tanqueo no garantiza el precio que cobre una estación.