Spain Fuel Station Prices Scraper (Gasolineras, official data)

What does Spain Fuel Station Prices Scraper do?

Spain Fuel Station Prices Scraper (Gasolineras) gives you the current price of every fuel at every service station in Spain as clean, numeric, spreadsheet-ready rows. It reads the Ministry of Industry's official open-data API (Geoportal Gasolineras, the same source behind the government's price map), converts the comma-decimal Spanish strings ("1,459") into numbers, translates the field names to English, and lets you filter by province, municipality, autonomous community, brand, fuel type, opening hours or a radius around a point, then sort by the cheapest price for the fuel you care about.

Every row is one station with 23 price columns (Gasolina 95 E5/E10/E25/E85, 95 Premium, Gasolina 98 E5/E10, Gasóleo A, Premium and B, renewable diesel HVO, renewable gasoline, biodiesel, bioethanol, LPG/Autogas, CNG, LNG, bio-CNG, bio-LNG, hydrogen, methanol, ammonia and AdBlue), plus address, postcode, municipality, province, region, WGS84 coordinates, a map link, opening hours, an open24h flag, public/restricted sale, road side, and the timestamp of the ministry's price list. Prices are refreshed by the stations roughly every 30 minutes.

It reads only the public, unauthenticated REST endpoints. The actor runs with Apify's limited permissions level: it can only read and write its own run storages and never touches other data in your account. It does not log in and does not collect personal data: the source has no contact fields at all, and the few independent stations whose sign is an individual's personal name get brand: null.

Why use it?

• Fleet managers and logistics: pull the cheapest Gasóleo A within 10 km of each depot every morning and route drivers accordingly.
• Price-comparison apps and chatbots: a JSON or CSV feed per province or municipality, already numeric and deduplicated, with coordinates for a map.
• Retail-margin and market analysts: track every Repsol, Moeve (Cepsa), BP, Galp, Ballenoil or Plenergy station's price by province over time; schedule daily runs and diff the datasets.
• AI agents and RAG pipelines: "What is the cheapest Gasolina 95 near Valencia airport?" becomes one actor call with latitude, longitude, radiusKm and sortBy: "G95E5".

On Apify you also get scheduling, webhooks, run monitoring and integrations (Google Sheets, Make, Zapier, LangChain, MCP).

How to use it

On the actor page, open the Input tab, pick one or more provinces (or municipalities, or regions), optionally set filters and a sort order, and click Start. Leave every field at its default to get the first 100 stations in the province of Madrid. The fields:

Field	Type	Default	Meaning
provinces	array of strings	["Madrid"]	Province names or two-digit ids ("Barcelona", "08", "Illes Balears", "La Coruña"), accent-insensitive
municipalities	array of strings	none	Municipality names (INE spelling) or ministry ids; add provinces to narrow the lookup, or write "Name (Province)"
regions	array of strings	none	Autonomous communities by name or id; used only when provinces and municipalities are empty
products	array of codes	none	Keep stations selling at least one of these fuels: G95E5, G95E10, G95E5+, G98E5, GOA, GOA+, GOB, DREN, GLP, GNC, GNL, H2, ADB, ...
brands	array of strings	none	Keep stations whose sign contains one of these words ("Repsol", "Cepsa", "BP")
only24h	boolean	false	Keep only stations open 24 hours, 7 days (L-D: 24H)
latitude, longitude, radiusKm	numbers	none	Radius search around a WGS84 point; rows get a distanceKm column and are sorted by distance
sortBy	none / distance / fuel code	none	Sort ascending by a fuel's price (stations without that fuel are dropped)
maxItems	integer	100	Stop after this many stations (max 15,000; the whole country is about 12,000)

Leave provinces, municipalities and regions all empty to download the national list (about 12 MB, 15-20 seconds) and filter it, for example with a radius or a brand.

Example input

Cheapest regular diesel in the province of Barcelona, 50 stations:

{
    "provinces": ["Barcelona"],
    "products": ["GOA"],
    "sortBy": "GOA",
    "maxItems": 50
}

Stations open 24 h within 8 km of Valencia city centre:

{
    "provinces": ["Valencia"],
    "latitude": 39.4699,
    "longitude": -0.3763,
    "radiusKm": 8,
    "only24h": true,
    "maxItems": 40
}

Major brands in two municipalities of Seville, sorted by Gasolina 95:

{
    "provinces": ["Sevilla"],
    "municipalities": ["Sevilla", "Dos Hermanas"],
    "brands": ["Repsol", "Cepsa", "Moeve", "BP"],
    "sortBy": "G95E5",
    "maxItems": 60
}

What data does it return?

One row per station. Prices are in EUR per litre (per kg for hydrogen and the gas fuels) and null when the station does not sell that fuel.

Field	Meaning
stationId	Ministry station id (stable across days)
brand	Station sign / brand (REPSOL, BALLENOIL, ...), null if none
address, postcode, locality, municipality, municipalityId, province, provinceId, region, regionId	Location
latitude, longitude, mapUrl	WGS84 coordinates and a Google Maps link
openingHours, open24h	Hours in the ministry's Spanish notation (L-D: 24H, L-V: 07:00-22:00; S: 08:00-14:00) and a 24/7 flag
saleType	public or restricted (cooperative / members only)
roadSide	right, left or none, relative to increasing kilometre points
reportingCode	Ministry reporting-channel code as published (OM or dm)
bioethanolPct, fameEsterPct	Bio-component shares declared by the station
priceGasoline95E5, priceGasoline95E10, priceGasoline95E25, priceGasoline95E85, priceGasoline95E5Premium, priceGasoline98E5, priceGasoline98E10	Gasoline prices
priceDieselA, priceDieselPremium, priceDieselB, priceRenewableDiesel, priceRenewableGasoline, priceBiodiesel, priceBioethanol	Diesel and bio prices
priceLpg, priceCng, priceLng, priceBioCng, priceBioLng, priceHydrogen, priceMethanol, priceAmmonia, priceAdblue	Gas and other prices
distanceKm	Only for radius searches: great-circle distance from the centre
pricesAsOf	Timestamp of the ministry's price list, Europe/Madrid local time
retrievedAt	UTC time the actor downloaded the list

Example output

{
    "stationId": "15493",
    "brand": "PLENERGY",
    "address": "CAMINO TORREJON, 4",
    "postcode": "28864",
    "locality": "AJALVIR",
    "municipality": "Ajalvir",
    "municipalityId": "4277",
    "province": "MADRID",
    "provinceId": "28",
    "region": "Madrid",
    "regionId": "13",
    "latitude": 40.528778,
    "longitude": -3.481639,
    "mapUrl": "https://www.google.com/maps?q=40.528778,-3.481639",
    "openingHours": "L-D: 24H",
    "open24h": true,
    "saleType": "public",
    "roadSide": "right",
    "reportingCode": "dm",
    "bioethanolPct": 0,
    "fameEsterPct": 0,
    "priceGasoline95E5": 1.459,
    "priceGasoline95E10": null,
    "priceGasoline98E5": null,
    "priceDieselA": 1.409,
    "priceDieselPremium": null,
    "priceLpg": null,
    "priceAdblue": null,
    "pricesAsOf": "2026-09-25 05:11:40",
    "retrievedAt": "2026-09-25T03:20:41.512Z"
}

(Shortened: the real row carries all 23 price columns.)

How much does it cost?

The actor is priced pay-per-event: a flat $0.01 per run plus $0.002 per station row saved to the dataset. You pay only for rows you receive; filtered-out stations and failed runs cost nothing beyond the start fee.

Run	Rows	Price
One municipality	25	$0.06
Default (province of Madrid, first 100)	100	$0.21
Whole province of Barcelona	~750	$1.51
Whole country	~11,500	$23.01

Platform usage (compute) for a province run is well under one cent and is included in your Apify plan. Set Maximum cost per run in the run options to cap what a run may charge; the actor stops cleanly at the cap.

Limits and things to know

• The ministry's API has no paging: a province is one request (0.3-1 MB), the whole country one 12 MB request. Filters and sorting are applied after download, so maxItems limits what you pay for, not what is downloaded.
• sortBy with a fuel code drops stations that do not sell that fuel. Use products alone if you want to keep the ministry's order.
• A radius search without provinces/regions downloads the whole country first; combine it with the province the point lies in for a faster run.
• Municipality names must follow the INE spelling used by the ministry ("Hospitalet de Llobregat (L')", "Acebeda (La)"); the actor also accepts the natural order ("La Acebeda") and tells you the candidates when a name is ambiguous or unknown.
• restricted sale stations (cooperatives) are included; filter on saleType afterwards if you only want public stations.
• Prices are those declared by the station operators under Spanish law (Orden ITC/2308/2007); the ministry does not verify them in real time.
• Memory: the default 512 MB is enough for any province; a whole-country run with sorting fits in 1 GB.

Data licence and attribution

The data comes from the Ministerio de Industria, Comercio y Turismo open-data service (sedeaplicaciones.minetur.gob.es/ServiciosRESTCarburantes), published for reuse under Spain's public-sector information law (Ley 37/2007) and listed on datos.gob.es. When you republish the data, credit the source as "Ministerio de Industria, Comercio y Turismo - Precios de carburantes en estaciones de servicio".

Personal data

None is collected. The source publishes station-level business data only (sign, address, hours, prices, coordinates); there are no operator, owner, e-mail or phone fields. Independent stations whose sign is a person's own name are returned with brand: null.

FAQ and support

Why does a station show every price as null? It reported no prices in the current half-hour cycle; run again later or check pricesAsOf.

Can I get historical prices? Not with this actor; schedule it daily and keep the datasets, or ask for the ministry's EstacionesTerrestresHist endpoint in an issue.

A municipality name is rejected. Add the province under provinces and use the spelling from the error message's suggestions, or pass the numeric municipalityId from a previous run.

Open an issue on the actor page for bugs or field requests.