Documentation

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&state=[state]&fields=[fields]

A Cities Request returns a list of supported Cities.

State

NSW, VIC, QLD, WA, SA, TAS, ACT, NT

Fields

…

Suburbs Request

https://fuelprice.io/api/?action=get_suburbs&state=[state]&fields=[fields]

A Suburbs Request returns a list of supported Suburbs within that State.

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.

Stations Request

https://fuelprice.io/api/?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.

state

NSW, WA, VIC, NT, QLD

fields

lat, long, address, street, suburb, postcode, phone, website, last_updated

City Average Request

https://fuelprice.io/api/?action=get_city_average&city=[city]

A City Average Request returns the current average retail price for a fuel type in that City.

City Spread Request

https://fuelprice.io/api/?action=get_city_spread&city=[city]

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.

City

See the Cities Request for a list of valid City slugs.

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.