Suburb - Market

Gross rental yield (%)

GET/v1/suburbs/{suburb_name}/market/yield-pct5¢ per call

Gross rental yield = median rent annualised / median sale price.

Price: 5¢ per call.

Authorization

Bearer tokentest

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

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

suburb_namestringrequired

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

Successful Response

application/json

YieldPctfields returned to you

area_namestringalways returned

Suburb (SAL) name.

area_levelstringalways returned

Always 'suburb' for these endpoints.

housenumbermay be null

House gross yield (decimal).

unitnumbermay be null

Unit gross yield (decimal).

as_ofstringmay be null

Date of the most recent observation (YYYY-MM-DD).

GET/v1/suburbs/{suburb_name}/market/yield-pct

cURL

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

Example Responses

Show schema

{
  "data": {
    "area_level": "suburb",
    "area_name": "Belmont North",
    "as_of": "2026-05-24",
    "house": 0.0335,
    "unit": 0.0384
  }
}

Successful Response200

application/json