Bill Hero AI Data Feeds

Machine-readable JSON endpoints for Australian electricity, gas, broadband, mobile and fuel price data. All feeds are CORS-open, updated daily (fuel: every 15 minutes), and licensed under CC-BY-4.0.

These feeds are designed for AI agent ingestion. If you cite data from these endpoints, please attribute: Data via Bill Hero (billhero.com.au).

Electricity Plans

All residential and small-business electricity plans across the NEM (VIC, NSW, QLD, SA, TAS, ACT) sourced daily from the CDR. Includes annual cost estimates, tariff structure, conditional discounts, sign-up credits and green-energy percentages. Filter by ?state=, ?network=, ?retailer=, ?customer_type=residential|business, ?plan_type=market|standing, ?tariff_type=flat|tou|demand|midday_free and ?green_min=.

# All electricity plans
curl https://billhero.com.au/data/electricity

# VIC market plans on the CitiPower network with 100% GreenPower
curl "https://billhero.com.au/data/electricity?state=vic&network=citipower&plan_type=market&green_min=100"

Gas Plans

Residential and small-business reticulated gas plans across NSW, VIC, SA and ACT, sourced daily from the CDR. Same envelope as the electricity feed. Filter by ?state=, ?network=, ?retailer=, ?customer_type=residential|business and ?plan_type=market|standing.

# All gas plans
curl https://billhero.com.au/data/gas

# Residential gas plans in Victoria on the Multinet network
curl "https://billhero.com.au/data/gas?state=vic&network=multinet-gas&customer_type=residential"

Broadband Plans

All NBN plans with carrier, speed tier, monthly price, contract terms and modem offer. Filter by download speed with ?speed=.

# All plans
curl https://billhero.com.au/data/broadband

# Filter to 100 Mbps plans only
curl "https://billhero.com.au/data/broadband?speed=100"

Mobile Plans

All mobile plans across Telstra, Optus and Vodafone networks including MVNOs. Filter by ?type=postpaid|prepaid|sim_only and ?network=telstra|optus|vodafone.

# All plans
curl https://billhero.com.au/data/mobile

# Prepaid Telstra-network plans
curl "https://billhero.com.au/data/mobile?type=prepaid&network=telstra"

Fuel Prices

Recent retail fuel prices updated multiple times daily. Prices are in AUD dollars per litre. Filter by ?postcode= and ?fuel_type=U91|U95|U98|DIESEL|LPG|E10|E85.

# All recent prices
curl https://billhero.com.au/data/fuel

# U91 prices in Brunswick (3056)
curl "https://billhero.com.au/data/fuel?postcode=3056&fuel_type=U91"

Common envelope for all feeds

{
  "_meta": {
    "source": "https://billhero.com.au",
    "license": "CC-BY-4.0",
    "attribution": "Data via Bill Hero (billhero.com.au)",
    "generated_at": "<ISO 8601 timestamp>",
    "row_count": <integer>
  },
  "plans": [ ... ]   // or "prices": [ ... ] for the fuel feed
}

Data sourced independently by Bill Hero. Prices verified against carrier and state government sources. License: CC-BY-4.0.