Income per microburb
/v1/suburbs/{suburb_name}/demographics/income-map10¢ per callMedian weekly household income for every microburb in the suburb, plus the suburb median, national percentile and highest/lowest pockets.
Exact suburb identifier required. Exact ABS Suburb and Locality (SAL) name, e.g. Burwood (NSW) — many suburbs carry a state suffix. If starting from free text or an unverified bare name, first call GET /v1/geocode/suburb?q=<text>, then use the exact data[].area_name it returns. Suburb data endpoints do not guess a state or typo-correct names.
Price: 10¢ per call.
Authorization
Request
The only values you send. Fields under Responses below are what comes back — you never pass those.
Path parameters
suburb_namestringrequiredExact ABS Suburb and Locality (SAL) name, e.g. `Burwood (NSW)` — many suburbs carry a state suffix. If starting from free text or an unverified bare name, first call `GET /v1/geocode/suburb?q=<text>`, then use the exact `data[].area_name` it returns. Suburb data endpoints do not guess a state or typo-correct names.
Query parameters
Responses
Successful Response
suburbstringalways returnedCanonical SAL name.
median_weekly_incomeintegermay be nullSuburb median household income ($/week).
national_percentileintegermay be nullNational income percentile, clamped 1-99.
n_microburbsintegeralways returnedMicroburbs with income data.
microburbsarray of IncomeMbalways returnedPer-microburb incomes.
highestobjectmay be nullHighest/lowest income pocket callout.
lowestobjectmay be nullHighest/lowest income pocket callout.
/v1/suburbs/{suburb_name}/demographics/income-mapcurl --request GET \
--url 'https://api.microburbs.com.au/v1/suburbs/Belmont%20North/demographics/income-map' \
--header 'Authorization: Bearer test'{
"data": {
"highest": {
"street": "Marquis St",
"weekly_income": 2105
},
"lowest": {
"street": "Kalaroo Rd",
"weekly_income": 1188
},
"median_weekly_income": 1740,
"microburbs": [
{
"mb": "10664530000",
"street": "Marquis St",
"weekly_income": 2105
}
],
"n_microburbs": 71,
"national_percentile": 55,
"suburb": "Belmont North"
}
}