Suburb - Street Forecasts

Street-level price forecasts

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

Unpaged by default. Large suburbs are large — Point Cook has 943 streets (~1.4 MB) — so pass limit/offset when you don't need the lot. total reports how many exist. Flat price per call regardless of page size.

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: 60¢ per call.

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

Request

  • Base URL: https://api.microburbs.com.au
  • URL: https://api.microburbs.com.au/v1/suburbs/{suburb_name}/street-forecasts
  • Auth: HTTP bearer

Path parameters

suburb_namestring required
Example:Belmont North

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

limitinteger nullable

Streets to return (default: all).

offsetinteger

Street offset — page with limit.

Response

Successful Response

availableboolean nullable

false on no-data responses. Omitted on success — branch on data !== null if you want a single discriminator.

reasonstring nullable

Machine-readable slug naming the no-data condition (e.g. no_avm_for_GANSW704074813). Stable per endpoint. Omitted on success.

messagestring nullable

Human-readable explanation. Omitted on success.

Example response

{
  "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
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.