FuelRadar APIfuelradar.com.au ↗

"""FuelRadar API — search fuel stations, compare prices, get cheapest fuel across Australia."""
from parse_apis.FuelRadar_API import FuelRadar, FuelType, StationNotFound

client = FuelRadar()

# Search nearby stations by coordinates (Sydney CBD), filter by Unleaded 91
for station in client.station_summaries.search(lat=-33.8688, lng=151.2093, fuel_type=FuelType.U91, limit=5):
    print(station.name, station.price, f"{station.distance}km")

# Drill into the first search result's full detail
hit = client.station_summaries.search(lat=-33.8688, lng=151.2093, limit=1).first()
if hit:
    detail = hit.details()
    print(detail.brand_name, detail.station_details.name, detail.station_details.address)
    for fp in detail.main_station_prices:
        print(f"  {fp.long_name}: {fp.price} c/L")

# Direct station lookup by ID with typed error handling
if hit:
    try:
        station = client.stations.get(station_id=hit.id)
        print(station.brand_name, station.station_details.suburb_name, station.station_details.state_name)
    except StationNotFound as exc:
        print(f"Station not found: {exc.station_id}")

# National overview — state averages and trends
overview = client.national_overviews.current()
print(f"Tracking {overview.total_stations} stations across {len(overview.states)} states")
for state in overview.states:
    print(state.name, state.avg_price, state.low)

# Top cheapest stations nationally
for cheap in client.ranked_stations.top_cheapest(limit=3):
    print(cheap.rank, cheap.name, cheap.price, cheap.state)

print("exercised: station_summaries.search / details / stations.get / national_overviews.current / ranked_stations.top_cheapest / StationNotFound")