Home / API
Free fuel price API
Read-only JSON, no key needed, up to 60 requests a minute per IP address.
Endpoints
GET /api/v1/stations?postcode=G21&fuel=E10&radius=5&sort=price
Forecourts near a postcode, or near lat and lon. fuel is one of E10, E5, B7_STANDARD, B7_PREMIUM, B10, HVO. sort is price, value or distance. For best value, add tank (litres) and mpg. radius is in miles, up to 25.
GET /api/v1/stations/{id}
One forecourt with all its prices and the price changes we have recorded.
GET /api/v1/forecast
Our current two-week estimate for UK average unleaded and diesel. signal and verdict are the advice from today, worked out from advice_today.change_to_target_pence: our estimate for target_date minus today's average forecourt price (1p or more down is fall, 1p or more up is rise, otherwise steady). weekly_call is the call as made from the survey price; past_calls_right and past_calls describe that weekly call only, so do not show them beside the advice from today. When advice_today.basis is weekly_call_only we could not measure the move since the survey, and remaining_change_from_now_pence is null. advice_today.change_to_one_week_date_pence is the change we expect between today and one_week_date; both are null once that date has passed, when there is no call today, or when the move since the survey could not be measured.
GET /api/v1/places
Every town and city we have a page for, with its centre point.
Using the data
- Prices are Fuel Finder data under the Open Government Licence v3.0. If you republish them you must credit the source and keep the retailer's price time (
price_set_at) unchanged. - Fields named
our_estimateand everything inforecastare our own estimates. Label them as estimates and keep them apart from reported prices. - Responses are cached for two minutes. Please do not poll faster than that.
- Going over the limit returns HTTP 429 with a
Retry-Afterheader.