Broadband Plans — JSON Data Feed
Machine-readable JSON of all Australian NBN broadband plans. Updated daily from verified carrier data. License: CC-BY-4.0. Attribution required: Data via Bill Hero (billhero.com.au).
Endpoint
GET https://billhero.com.au/data/broadband GET https://billhero.com.au/data/broadband?speed_min=100 GET https://billhero.com.au/data/broadband?contract_months=0&speed_min=100 GET https://billhero.com.au/data/broadband?carrier=aussie-bb&monthly_price_max=79
Available filters
| Parameter | Type | Description | Example |
|---|---|---|---|
| carrier | string | Carrier slug (exact match) | aussie-bb |
| monthly_price_max | number | Max monthly price AUD | 79 |
| speed_min | number | Min download speed Mbps | 100 |
| speed_max | number | Max download speed Mbps | 100 |
| contract_months | number | Contract length in months; 0 = no lock-in | 0 |
| modem_offer | string (comma-list) | Modem offer type: free_unconditional | free_with_contract | free_with_contract_includes_mesh | optional_purchase | optional_rental | byo_required | free_unconditional,free_with_contract |
Example: https://billhero.com.au/data/broadband?contract_months=0&speed_min=100
Response schema
{
"_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": number,
"filters_applied": { ...active filters }
},
"plans": [
{
"carrier": string,
"plan_name": string,
"monthly_price_aud": number | null,
"speed_down_mbps": number | null,
"speed_up_mbps": number | null,
"contract_term": number | null,
"setup_fee": number | null,
"modem_included": boolean | null,
"modem_offer": string | null,
"source_captured_at": string
}
]
}curl examples
# All broadband plans curl https://billhero.com.au/data/broadband # No-contract 100 Mbps+ plans curl "https://billhero.com.au/data/broadband?contract_months=0&speed_min=100" # Plans under $70/mo on Aussie BB curl "https://billhero.com.au/data/broadband?carrier=aussie-bb&monthly_price_max=70" # Plans with free modem (unconditional or bundled) curl "https://billhero.com.au/data/broadband?modem_offer=free_unconditional,free_with_contract"
Cache-Control: public, s-maxage=3600, stale-while-revalidate=86400. License: CC-BY-4.0. Data sourced independently by Bill Hero from carrier websites.