Suburb - Street Forecasts

Street-level price forecasts

GET/v1/suburbs/{suburb_name}/street-forecasts60¢ per call

2/4/8-year price forecasts for every street in the suburb, anchored to the real sold median.

Price: 60¢ 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

StreetForecastsfields returned to you

area_namestringalways returned

Suburb (SAL) name.

area_levelstringalways returned

Always 'suburb'.

metricstringalways returned

Always 'street_price_forecasts'.

streetsarray of StreetForecastRowalways returned

One row per forecastable street, unordered.

GET/v1/suburbs/{suburb_name}/street-forecasts

cURL

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

Example Responses

Show schema

{
  "data": {
    "area_level": "suburb",
    "area_name": "Belmont North",
    "metric": "street_price_forecasts",
    "streets": [
      {
        "annual_2y": 8,
        "annual_4y": 6.3,
        "annual_8y": 5,
        "current_price": 1159000,
        "history": [
          {
            "price": 1038603.34,
            "suburb_med": 866399,
            "year": 2024
          },
          {
            "price": 1083975.34,
            "suburb_med": 948908,
            "year": 2025
          },
          {
            "price": 1159000,
            "suburb_med": 1040068,
            "year": 2026
          }
        ],
        "houses_on_street": 146,
        "median_house_rent_week": 791.2,
        "n_sales": 289,
        "rental_turnover": "Every 5.9 years (quite tightly held)",
        "renters_pct": "18%",
        "sale_turnover": "Every 12.0 years (average turnover)",
        "street": "Wommara Ave",
        "target_2y": 1352652.97,
        "target_4y": 1480849.45,
        "target_8y": 1718217.61,
        "units_on_street": 4
      }
    ]
  }
}

Successful Response200

application/json