Population and dwellings by mesh block (by suburb)
/v1/suburbs/{suburb_name}/demographics/population-map20¢ per callResidents and dwellings on every microburb (mesh block) in the suburb,
with the suburb totals. Values only; polygons come from
/shapes/mesh-blocks.
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: 20¢ 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.
metricstringalways returnedAlways 'population'.
unitstringalways returnedAlways 'people'.
definitionstringalways returnedHow the figure is derived.
populationintegeralways returnedResidents summed over the suburb's microburbs.
dwellingsintegeralways returnedDwellings summed over the suburb's microburbs.
n_microburbsintegeralways returnedMicroburbs in the suburb.
microburbsarray of PopulationMbalways returnedEvery microburb, by mesh-block code.
/v1/suburbs/{suburb_name}/demographics/population-mapcurl --request GET \
--url 'https://api.microburbs.com.au/v1/suburbs/Belmont%20North/demographics/population-map' \
--header 'Authorization: Bearer test'{
"data": {
"suburb": "Belmont North",
"metric": "population",
"unit": "people",
"definition": "Usual residents and dwellings on each mesh block ('microburb', ~30-60 dwellings). Every block in the suburb is listed, including parkland and commercial blocks with no residents. The sums are the suburb's totals.",
"population": 6280,
"dwellings": 2453,
"n_microburbs": 85,
"microburbs": [
{
"mb": "10431160000",
"street": "Floraville",
"population": 51,
"dwellings": 23
}
]
}
}