Petrolmate for Home Assistant

API Endpoint

Petrolmate provides a free, public JSON API designed for Home Assistant and smart home integrations. No API key required.

Endpoint

GET https://petrolmate.com.au/api/v1/stations/area

Parameters

Parameter	Type	Default	Description
lat	float	required	Latitude of your location
lng	float	required	Longitude of your location
radius	integer	5000	Search radius in metres (max 25,000)
limit	integer	30	Max stations returned (max 50)

Example Request

curl "https://petrolmate.com.au/api/v1/stations/area?lat=-33.87&lng=151.21&radius=5000&limit=5"

Example Response

{
  "success": true, "count": 3, "api": "petrolmate", "version": "1.0", "coverage": "AU+NZ",
  "stations": [
    {
      "id": 1234, "name": "Shell Woolloomooloo", "brand": "Shell",
      "address": "61 Cowper Wharf Rd", "suburb": "Woolloomooloo",
      "state": "NSW", "lat": -33.8696, "lng": 151.2213, "distance_m": 1115,
      "fuels": [
        {"type": "ULP",    "name": "Unleaded 91",  "price": 259.9, "updated": "2026-03-30T12:00:02"},
        {"type": "E10",    "name": "E10",           "price": 257.9, "updated": "2026-03-30T12:00:02"},
        {"type": "PULP95", "name": "Premium 95",    "price": 277.4, "updated": "2026-03-30T12:00:02"},
        {"type": "DIESEL", "name": "Diesel",        "price": 289.9, "updated": "2026-03-30T12:00:02"}
      ]
    }
  ]
}

Rate Limits and Fair Use

Supported Fuel Types

Code	Name	Coverage
ULP	Unleaded 91	All States + NZ
E10	E10 Ethanol	NSW, QLD, VIC, SA, ACT
PULP95	Premium 95	All States + NZ
PULP98	Premium 98	All States
DIESEL	Diesel	All States + NZ
PDIESEL	Premium Diesel	Most States
LPG	LPG Autogas	NSW, VIC, QLD, SA

REST Sensor Setup

Add this to your Home Assistant configuration.yaml. Replace the latitude and longitude with your home coordinates.

Basic: Cheapest ULP Nearby

rest:
  - resource: "https://petrolmate.com.au/api/v1/stations/area?lat=-33.87&lng=151.21&radius=5000&limit=10"
    scan_interval: 300
    sensor:
      - name: "Cheapest ULP Nearby"
        value_template: >
          {% set ns = namespace(cheapest=none) %}
          {% for station in value_json.stations %}
            {% for fuel in station.fuels if fuel.type == 'ULP' %}
              {% if ns.cheapest is none or fuel.price < ns.cheapest %}
                {% set ns.cheapest = fuel.price %}
              {% endif %}
            {% endfor %}
          {% endfor %}
          {{ ns.cheapest }}
        unit_of_measurement: "c/L"

Multi-Sensor: Nearest Station + Fuel Types

rest:
  - resource: "https://petrolmate.com.au/api/v1/stations/area?lat=-33.87&lng=151.21&radius=5000&limit=10"
    scan_interval: 300
    sensor:
      - name: "Nearest Station"
        value_template: "{{ value_json.stations[0].name }}"
      - name: "Nearest ULP Price"
        value_template: >
          {{ value_json.stations[0].fuels | selectattr('type','eq','ULP')
              | map(attribute='price') | first | default('N/A') }}
        unit_of_measurement: "c/L"
      - name: "Nearest Diesel Price"
        value_template: >
          {{ value_json.stations[0].fuels | selectattr('type','eq','DIESEL')
              | map(attribute='price') | first | default('N/A') }}
        unit_of_measurement: "c/L"
      - name: "Stations in Range"
        value_template: "{{ value_json.count }}"

Automation: Price Alert

automation:
  - alias: "Fuel Price Alert"
    trigger:
      - platform: numeric_state
        entity_id: sensor.cheapest_ulp_nearby
        below: 250
    action:
      - service: notify.mobile_app
        data:
          title: "Cheap Fuel Alert"
          message: "ULP dropped to {{ states('sensor.cheapest_ulp_nearby') }}c/L nearby!"

Data Sources

Petrolmate aggregates prices from official government APIs across every Australian state plus community data.

State	Source	Type
New South Wales	NSW FuelCheck	Official
Queensland	QLD Fair Fuel	Official
South Australia	SA Fuel Pricing	Official
Victoria	VIC Fair Fuel	Official
Western Australia	WA FuelWatch	Official
Tasmania	TAS FuelCheck	Official
Northern Territory	NT MyFuel	Official
ACT + Broader	Community data	Community
New Zealand	Community data	Community

Official government sources are prioritised. Fresh official data (under 48 hours) takes precedence over community data.

FAQ