Spain Gas API

API para obtener los precios de las gasolineras en España.

API de Gasolina de España

Los datos oficiales de precios de combustible de España, en una API JSON limpia.

API · Fuente

El Ministerio para la Transición Ecológica (MITECO) publica los precios de combustible de todas las gasolineras del país — pero la API pública es complicada de usar: necesitas hacer una búsqueda de ID de municipio antes de poder solicitar precios, y la respuesta es una carga masiva y con formato español (decimales con coma, nombres de campos nacionales). Construí una capa fina encima que hace el encadenamiento y el formato por ti, así que una única solicitud te devuelve datos limpios.

Qué hace

  • Una solicitud por municipio y provincia devuelve los precios de todas las gasolineras para gasolina, diésel, GNC, GNL e hidrógeno — como números simples
  • ¿Sin fecha? Sin problema — usa por defecto la fecha de ayer, ya que los datos del gobierno de hoy a menudo siguen incompletos
  • Sin clave de API, sin registro — accede al endpoint y recibe JSON

Cómo está construido

Una Serverless Lambda en Python detrás de API Gateway: la función recibe la solicitud, resuelve el municipio al ID interno de MITECO, llama a la API del gobierno y reformatea la respuesta antes de devolverla. Cero dependencias de terceros — solo la librería estándar de Python — y probado con pruebas unitarias usando respuestas de API del gobierno simuladas que cubren las rutas de validación, análisis y error.

  • Sin dobles llamadas — la tabla de búsqueda municipio → ID (miles de entradas) se incluye con la Lambda como archivo local, así que cada solicitud salta directamente a obtener precios en lugar de resolver IDs primero
  • Pensado para crecer — cada endpoint vive en su propia carpeta con su propia Lambda y README; los nuevos se agregan de la misma manera, con lanzamientos registrados en un CHANGELOG.md con versionado semántico y formato Keep-a-Changelog
  • Documentado e implementado — una especificación OpenAPI 3.0 se incluye en el repositorio, y la API misma se ejecuta en AWS Lambda + API Gateway

Prueba el endpoint en directo — precios reales, ahora mismo.