Single-parent families
/v1/suburbs/{suburb_name}/demographics/single-parents3¢ per callSingle-parent-family share for the suburb against the pinned national median, with the associated capital-growth impact.
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: 3¢ 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.
single_parent_pctnumberalways returnedSingle-parent-family share as a percentage.
national_median_pctnumberalways returnedThe Australia-wide single-parent-family share to compare `single_parent_pct` against, as a percentage — a fixed 2021 Census benchmark, identical in every response. A different metric and a different number from the unemployment endpoint's benchmark of the same name.
vs_nationalstringalways returnedWhether this suburb's single-parent share sits 'below' or 'above' the national benchmark. Exact equality is reported as 'above'.
growth_impactobjectalways returnedWhat a suburb's score on this indicator has historically gone together with, in capital-growth terms. ⚠️ **This is an association, not a prediction, and not a calculation from this suburb's own numbers.** The suburb is sorted into one of a few bands, and each band carries a fixed figure drawn from Microburbs' research across many suburbs. Two suburbs in the same band always return exactly the same `pct_per_year`. Do not add these up across indicators to build a growth forecast, and do not present the figure as something this suburb will do.
/v1/suburbs/{suburb_name}/demographics/single-parentscurl --request GET \
--url 'https://api.microburbs.com.au/v1/suburbs/Belmont%20North/demographics/single-parents' \
--header 'Authorization: Bearer test'{
"data": {
"growth_impact": {
"band": "High single-parent share",
"pct_per_year": -0.5
},
"national_median_pct": 5.8,
"single_parent_pct": 11,
"suburb": "Belmont North",
"vs_national": "above"
}
}