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

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.
FuelPrice Australia