Microburbs
Microburbs API
Live sandbox. Send any request below against one sample suburb and property — no signup needed. For full coverage, create an API key.
Classic docs
Microburbs Property Data API
Suburb - Demographics

Single-parent families by mesh block (by suburb)

GET/v1/suburbs/{suburb_name}/demographics/single-parents-map20¢ per call

Single-parent families as a share of families for every microburb (mesh block) in the suburb, percent 0-100. Near-empty blocks are left out. The suburb figure is /demographics/single-parents. 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_namestringrequired

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.

Query parameters

None — this endpoint accepts no query parameters. Call the path above with your bearer token and nothing else.

Responses

Successful Response

application/json
SuburbSingleParentsMapfields returned to you
suburbstringalways returned

Canonical SAL name.

metricstringalways returned

Always 'single_parent_pct'.

unitstringalways returned

Always 'percent'.

definitionstringalways returned

How the figure is derived.

n_microburbsintegeralways returned

Microburbs with a figure.

microburbsarray of SingleParentsMbalways returned

Per-microburb shares, by mesh-block code.

GET/v1/suburbs/{suburb_name}/demographics/single-parents-map
cURL
curl --request GET \
  --url 'https://api.microburbs.com.au/v1/suburbs/Belmont%20North/demographics/single-parents-map' \
  --header 'Authorization: Bearer test'
Example Responses
{
  "data": {
    "suburb": "Belmont North",
    "metric": "single_parent_pct",
    "unit": "percent",
    "definition": "Single-parent families as a share of families on each mesh block ('microburb', ~30-60 dwellings), percent 0-100. A modelled estimate for the block, not a count. Blocks with fewer than 10 residents or 5 dwellings are left out. Compare the suburb figure at /demographics/single-parents.",
    "n_microburbs": 63,
    "microburbs": [
      {
        "mb": "10431160000",
        "street": "Floraville",
        "single_parent_pct": 5.2
      }
    ]
  }
}
Successful Response200
application/json