API de Naftas

API pública para consultar precios actualizados de combustible en Argentina. Los datos provienen de datos.energia.gob.ar y se cachean por 6 horas.

Endpoint

GEThttps://naftas.com.ar/api/fuel

Parámetros

cityreq.

string

Nombre de la ciudad en mayúsculas. Por ejemplo: CAPITAL FEDERAL, CÓRDOBA, ROSARIO.

Ejemplo de petición

HTTP

GET https://naftas.com.ar/api/fuel?city=CAPITAL%20FEDERAL

cURL

curl "https://naftas.com.ar/api/fuel?city=CAPITAL%20FEDERAL"

JavaScript

const res = await fetch("https://naftas.com.ar/api/fuel?city=CAPITAL FEDERAL")
const data = await res.json()
console.log(data)

Respuesta

Devuelve un objeto donde cada clave es una ciudad. Dentro de cada ciudad, empresas contiene cada compañía y sus combustibles con precio y fecha de vigencia.

JSON (200 OK)

{
  "CAPITAL FEDERAL": {
    "empresas": {
      "YPF": {
        "Nafta Super": {
          "precio": 1420.5,
          "fecha_vigencia": "2024-10-15T00:00:00",
          "horario": "dia"
        },
        "Infinia": {
          "precio": 1680.0,
          "fecha_vigencia": "2024-10-14T00:00:00",
          "horario": "dia"
        }
      },
      "SHELL C.A.P.S.A.": {
        "V-Power Nafta": {
          "precio": 1695.0,
          "fecha_vigencia": "2024-10-15T00:00:00",
          "horario": "dia"
        }
      }
    }
  }
}

Campos de la respuesta

precio

number

Precio por litro (o m³ en GNC) en pesos argentinos.

fecha_vigencia

string

Fecha de la última actualización del precio en formato ISO 8601.

horario

string

Franja horaria: 'dia' (06–22h) o 'noche' (22–06h). Algunos surtidores segmentan su tarifa.

Caché

s-maxage: 21600s (6 horas)

stale-while-revalidate: 10800s (3 horas)

Las respuestas pueden estar desactualizadas hasta 9 horas en escenarios de alta carga.

Errores

400

Falta el parámetro city. Respuesta: { "error": "Missing required parameter: city" }

500

Error interno al consultar la fuente de datos externa.

Fuente de datos

Los precios se obtienen del portal de datos abiertos del Ministerio de Energía de Argentina ( datos.energia.gob.ar). El algoritmo aplica un filtro de antigüedad de 20 días (con fallback a 60 días) y rechaza valores que se desvíen más de ±30% de la mediana de la ciudad para reducir outliers.