# Fuel Prices Scraper France & Spain - Gas Stations (`thequietstack/fuel-prices-france-spain`) Actor

Cheapest fuel near you: official open data of all gas stations in France and Spain with diesel, E10, 95, 98, LPG and E85 prices, address, coordinates and update time. Filter by radius, city or postcode. No login. Pay per station.

- **URL**: https://apify.com/thequietstack/fuel-prices-france-spain.md
- **Developed by:** [TheQuietStack](https://apify.com/thequietstack) (community)
- **Categories:** Travel, Open source
- **Security:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.35 / 1,000 gas stations

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Fuel Prices Scraper France & Spain: every gas station, cheapest first

Current **diesel, petrol 95 (E5/E10), 98, LPG and E85 prices of about 20,600 gas stations** in **France (9,289)** and **Spain (11,311)**, read from the official national open-data files — no login, no API key, no browser, no scraping of consumer apps. Filter by **radius around a point, city/province, postal code prefix, fuel type and maximum price**, sort cheapest first or nearest first.

**Typical uses:** cheapest fuel on a route or around a depot · fleet and logistics cost planning · price-comparison sites and apps · journalism and market research on regional fuel price gaps · daily price snapshots (schedule the actor) for time series.

### Input

```json
{ "countries": ["FR", "ES"], "fuelTypes": ["diesel"], "sortByFuel": "diesel", "maxStations": 50 }
```

Around a point (Paris, 10 km, E10, nearest first):

```json
{ "countries": ["FR"], "fuelTypes": ["petrol95_e10"], "latitude": 48.8566, "longitude": 2.3522, "radiusKm": 10, "sortBy": "distance", "maxStations": 20 }
```

Other filters: `postalCodes` (prefixes, e.g. `["28","08"]`), `city` (case/accent insensitive, matches city or Spanish province), `maxPrice`, `includeMembersOnly` (Spanish stations that sell to members only are skipped by default).

### Output (real run, 5 Nov 2026)

```json
{
 "country": "FR", "stationId": "75012010", "address": "36 Quai de la Rapée", "postalCode": "75012", "city": "Paris",
 "latitude": 48.84, "longitude": 2.37, "distanceKm": 2.2, "currency": "EUR", "unit": "per litre",
 "prices": { "diesel": 2.284, "petrol95_e10": 2.096, "petrol98": 2.196 },
 "pricesUpdatedAt": { "diesel": "2026-11-04T07:31:00", "petrol95_e10": "2026-11-04T07:31:00", "petrol98": "2026-11-04T07:31:00" },
 "services": ["..."], "mapUrl": "https://www.openstreetmap.org/?mlat=…"
}
```

Price keys: `diesel`, `diesel_premium` (ES), `petrol95`, `petrol95_e10`, `petrol98`, `e85`, `lpg`. Timestamps are local time as published (France per fuel, Spain: time of the national file).
Test run: both countries, diesel, 50 cheapest of 20,260 matching stations; cheapest in Spain 1.381 EUR/l.

### Price

Pay per result: **$0.0005 per station** (about $0.50 per 1,000; volume tiers are cheaper). A tiny start fee applies per run. Set a maximum cost per run; the run stops cleanly when it is reached. Filtering is free: you pay only for the stations returned.

### Sources and licence

- France: *Prix des carburants en France – flux instantané*, data.gouv.fr / Ministère de l'Économie, **Licence Ouverte (Etalab 2.0)**.
- Spain: *Precios de carburantes*, Ministerio para la Transición Ecológica y el Reto Demográfico, open data.
  Please credit the sources when you publish the data. Prices are as reported by the stations to the authorities and can lag behind the pump. Not affiliated with any authority or fuel brand.

# Actor input Schema

## `countries` (type: `array`):

Which national open-data files to read.

## `fuelTypes` (type: `array`):

Only stations that sell every selected fuel are returned. Empty = any station.

## `sortByFuel` (type: `string`):

Cheapest first, for this fuel.

## `sortBy` (type: `string`):

Order of the result.

## `latitude` (type: `number`):

Optional center point, e.g. 48.8566 (Paris).

## `longitude` (type: `number`):

Optional center point, e.g. 2.3522 (Paris).

## `radiusKm` (type: `number`):

With center point: only stations within this distance.

## `postalCodes` (type: `array`):

e.g. 75 (Paris), 28 (Madrid), 08 (Barcelona), 13001.

## `city` (type: `string`):

Case and accent insensitive, e.g. Lyon, Sevilla.

## `maxPrice` (type: `number`):

Applies to the sorting fuel.

## `includeMembersOnly` (type: `boolean`):

Some Spanish stations (e.g. cooperatives) sell to members only. They are skipped by default.

## `maxStations` (type: `integer`):

Result size after sorting.

## Actor input object example

```json
{
  "countries": [
    "FR",
    "ES"
  ],
  "fuelTypes": [
    "diesel"
  ],
  "sortByFuel": "diesel",
  "sortBy": "price",
  "includeMembersOnly": false,
  "maxStations": 100
}
```

# Actor output Schema

## `apps` (type: `string`):

No description

## `summary` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {};

// Run the Actor and wait for it to finish
const run = await client.actor("thequietstack/fuel-prices-france-spain").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {}

# Run the Actor and wait for it to finish
run = client.actor("thequietstack/fuel-prices-france-spain").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{}' |
apify call thequietstack/fuel-prices-france-spain --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,thequietstack/fuel-prices-france-spain"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/avqH2YQ7cbBgSED57/builds/KeiQE5AwWNyVR6dhG/openapi.json