FuelPrice Australia API – Overview
The FuelPrice Australia API allows you to look up the average retail fuel price and where supported current fuel station prices, returning (where available):
- Current average retail fuel prices at a Suburb, State, LGA and National level
- The current cheapest and most expensive Stations at a Suburb and City level
- Current fuel station prices
- The current spread (min, max, saving) of retail fuel prices at a City level
API Request Types
Additional Request Types are being added all the time and will appear here.
- Cities Request
- Suburbs Request
- Fuel Types Request
- Stations Request
- City Average Request
- City Spread Request
Cities Request
https://fuelprice.io/api/?action=get_cities https://fuelprice.io/api/?action=get_cities&state=[state] https://fuelprice.io/api/?action=get_cities&state=[state]&fields=[fields]
A Cities Request returns a list of supported Cities.
Note: This API endpoint does not require a Secret Key.
State
NSW, VIC, QLD, WA, SA, TAS, ACT, NT
Fields
…
Suburbs Request
https://fuelprice.io/api/?key=[secret_key]&action=get_suburbs https://fuelprice.io/api/?key=[secret_key]&action=get_suburbs&state=[state] https://fuelprice.io/api/?action=get_suburbs&state=[state]&fields=[fields]
A Suburbs Request returns a list of supported Suburbs within that State.
Note: This API endpoint requires a Secret Key.
State
NSW, VIC, QLD, WA, SA, TAS, ACT, NT
Fields
…
Fuel Types Request
https://fuelprice.io/api/?action=get_fuel_types
A Fuel Types Request returns a list of supported fuel types.
Note: This API endpoint does not require a Secret Key.
Stations Request
https://fuelprice.io/api/?key=[secret_key]&action=get_stations&state=[state] https://fuelprice.io/api/?key=[secret_key]&action=get_stations&state=[state]&fields=[fields]
A Stations Request returns a list of known Stations within that State. Stations Requests is limited to States where Stations are supported.
Note: This API endpoint requires a Secret Key.
state
NSW, WA, VIC, NT, QLD
fields
lat, long, address, street, suburb, postcode, phone, website, last_updated
City Average Request
https://fuelprice.io/api/?key=[secret_key]&action=get_city_average&city=[city] https://fuelprice.io/api/?key=[secret_key]&action=get_city_average&state=[state]
A City Average Request returns the current average retail price for a fuel type in that City.
Note: This API endpoint requires a Secret Key.
state
NSW, WA, VIC, NT, QLD
Fields
average_price
City Spread Request
https://fuelprice.io/api/?key=[secret_key]&action=get_city_spread&city=[city] https://fuelprice.io/api/?key=[secret_key]&action=get_city_spread&state=[state]
A City Spread Request returns the current spread between the cheapest and most expensive fuel stations for a fuel type in that City. City Spread Requests is limited to States where Stations are supported.
Note: This API endpoint requires a Secret Key.
City
See the Cities Request for a list of valid City slugs.
state
NSW, WA, VIC, NT, QLD
Notes
- Data source outages may cause data to be missing.
- The FuelPrice Australia API supports HTTP compression. To enable it, simply add an
Accept-Encoding: gzip
header to your request.