Suburb - Market

Investor concentration

GET/v1/suburbs/{suburb_name}/market/investor-concentration10¢ per call

Rental (investor) share per mesh block, with a suburb-wide rollup.

Price: 10¢ per call.

Authorization

Bearer tokentest

Sandbox key test works for the allowlisted GNAF + SAL — no signup.

Request

The only values you send. Fields under Responses below are what comes back — you never pass those.

Path parameters

suburb_namestringrequired

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

InvestorConcentrationfields returned to you

area_namestringalways returned

Suburb (SAL) name.

area_levelstringalways returned

Always 'suburb' for these endpoints.

rental_share_pctnumbermay be null

Suburb rollup: rentals / total dwellings across all MBs (%).

total_propertiesintegermay be null

Total occupied dwellings across the suburb's MBs.

rental_propertiesintegermay be null

Total rental dwellings across the suburb's MBs.

mbsarray of InvestorConcentrationMbalways returned

Per-mesh-block breakdown.

GET/v1/suburbs/{suburb_name}/market/investor-concentration

cURL

curl --request GET \
  --url 'https://api.microburbs.com.au/v1/suburbs/Belmont%20North/market/investor-concentration' \
  --header 'Authorization: Bearer test'

Example Responses

Show schema

{
  "data": {
    "area_level": "suburb",
    "area_name": "Belmont North",
    "mbs": [
      {
        "avg_annual_growth": 0.0705,
        "mb": "11205845900",
        "pct_investment": 28.95,
        "rental_properties": 11,
        "total_properties": 38
      }
    ],
    "rental_properties": 966,
    "rental_share_pct": 27.4,
    "total_properties": 3521
  }
}

Successful Response200

application/json