# Naftas Argentina

> Directorio de precios de combustibles en tiempo real para Argentina. Cobertura nacional con datos oficiales de YPF, Shell, Axion y PUMA. Actualización automática diaria desde datos abiertos del Ministerio de Energía de Argentina (datos.energia.gob.ar).

Naftas.com.ar es una aplicación web gratuita para consultar y comparar precios de nafta súper, nafta premium, gasoil/diesel y GNC en ciudades de todo el país. Los usuarios pueden filtrar por tipo de combustible, ordenar por precio o por vigencia, y calcular cuánto cuesta cargar una cantidad de litros o un presupuesto determinado.

## API pública de precios

- [Precios por ciudad](https://naftas.com.ar/api/fuel?city=CAPITAL+FEDERAL): Retorna JSON con precios actuales, empresa y fecha de vigencia para la ciudad indicada. Parámetro requerido: `city` en mayúsculas (ej: `CAPITAL FEDERAL`, `CORDOBA`, `ROSARIO`, `MENDOZA`, `TUCUMAN`).
- [Ciudades disponibles](https://naftas.com.ar/api/cities): Lista JSON de todas las ciudades con datos activos en la base de datos.
- [Ciudades cercanas](https://naftas.com.ar/api/cities?city=CORDOBA): Lista JSON de ciudades con datos más cercanas a la ciudad indicada, ordenadas por distancia.
- [Documentación completa de la API](https://naftas.com.ar/api-docs): Parámetros, estructura de respuesta, códigos de error y política de caché.

## Combustibles cubiertos

- **Nafta Súper** (RON 95): combustible estándar de nafta en Argentina
- **Nafta Premium / Infinia / V-Power** (RON 97–100): nafta de alto octanaje
- **Gasoil / Diesel 500**: combustible diésel estándar
- **Infinia Diesel / Gasoil Premium**: diésel de alta calidad
- **GNC** (Gas Natural Comprimido): precio en pesos por metro cúbico (m³)

## Estaciones de servicio cubiertas

YPF · Shell (SHELL C.A.P.S.A.) · Axion Energy · PUMA Energy

## Estructura de la respuesta API

```json
{
  "CAPITAL FEDERAL": {
    "empresas": {
      "YPF": {
        "Nafta Super": {
          "precio": 1420.50,
          "fecha_vigencia": "2024-10-15T00:00:00"
        },
        "Infinia": {
          "precio": 1680.00,
          "fecha_vigencia": "2024-10-15T00:00:00"
        }
      },
      "SHELL C.A.P.S.A.": {
        "V-Power Nafta": {
          "precio": 1695.00,
          "fecha_vigencia": "2024-10-15T00:00:00"
        }
      }
    }
  }
}
```

El campo `precio` está en pesos argentinos (ARS) por litro, o por m³ en el caso del GNC. El campo `fecha_vigencia` indica la fecha de vigencia oficial del precio según resolución ministerial.

## Fuente y actualización

Datos obtenidos del portal de datos abiertos del Ministerio de Energía de la Nación Argentina (datos.energia.gob.ar). El proceso de sincronización aplica filtros de antigüedad (20 días, con fallback a 60 días) y descarta valores que se desvíen más de ±30% de la mediana de la ciudad para reducir outliers. Las respuestas de la API tienen caché de 6 horas con stale-while-revalidate de 3 horas adicionales.

## Cobertura geográfica

Todo el territorio argentino continental. Ciudades con datos: Capital Federal (Buenos Aires), Córdoba, Rosario, Mendoza, Tucumán, La Plata, Mar del Plata, Salta, San Miguel de Tucumán, Neuquén, Resistencia, Corrientes, Posadas, Santiago del Estero, San Juan, San Luis, Santa Rosa, Río Cuarto, Bahía Blanca y más de 100 localidades.

## Uso de los datos

Los datos son de consulta libre y gratuita. Provienen de una fuente gubernamental bajo licencia de datos abiertos. Naftas.com.ar no garantiza disponibilidad continua del servicio.