Fuel Prices API
No API key. Diesel, petrol and LPG prices at fuel stations near any point in France, Spain and Italy (cheapest first, official government feeds) plus the official weekly pump-price averages for all 27 EU countries with history since 2005. Price monitor mode returns only changes.
Example request
curl -X POST https://radarbg.com/v1/europe-fuel-prices \
-H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" \
-d '{"mode": "both", "latitude": 48.8566, "longitude": 2.3522, "radiusKm": 5}'
Answer: {"ok": true, "count": N, "items": [...], "usage": {...}}. Failed calls are not counted.
Inputs
| Field | Type | Description |
|---|---|---|
mode | string | both = station prices near the point plus the weekly national averages; stations = only stations near the point (France, Spain, Italy); averages = only the official weekly averages per EU country. |
latitude | number | Latitude of the point to search around (WGS84), e.g. 48.8566 for Paris, 40.4168 for Madrid, 41.9028 for Rome. Station prices cover France, Spain and Italy. |
longitude | number | Longitude of the point to search around (WGS84), e.g. 2.3522 for Paris. |
radiusKm | number | Search radius around the point in kilometres, 0.5 to 50. |
fuel | string | Fuel to price and sort by: diesel, petrol95 (E5), petrol95_e10, petrol98, lpg, e85, cng, lng, diesel_premium, petrol_premium, adblue, hydrogen, or all (every fuel the station sells, sorted by distance). Every row also lists all fuels of the |
sortBy | string | price = cheapest first (ties by distance); distance = nearest first. |
maxStations | integer | Maximum number of stations to return, 1 to 200. |
averageCountries | array | ISO country codes for the official EU Weekly Oil Bulletin averages (any of the 27 EU countries, plus EU for the EU-27 average and EA for the euro area). Use ["ALL"] for all. Leave empty in both mode to skip averages. |
historyWeeks | integer | Add the last N weekly prices to every average row (0 = none, up to 1,100 weeks back to 2005). |
onlyNew | boolean | Return only stations whose price changed (price_down / price_up / new_station) and only new weekly averages since the last run with the same Monitor ID. The first run returns everything. Use it on a schedule. |
monitorId | string | Name of the watch list for Only changes mode, e.g. paris-diesel. Each Monitor ID keeps its own memory. |
Price
Included in every plan: 100 calls a month free, then from €9 a month for 3,000 calls across all APIs.