Suburb - Demographics

Total population, history & projection

Total suburb population is current_population (ABS Census 2021), alongside suburb census points (2011/2016/2021) and the LGA's yearly population series with a 10-year modelled projection tail. Use this route for questions such as "what is the total population of Clarkson?

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

get/v1/suburbs/{suburb_name}/demographics/population-history

Request

  • Base URL: https://api.microburbs.com.au
  • URL: https://api.microburbs.com.au/v1/suburbs/{suburb_name}/demographics/population-history
  • 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.

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": {
    "census_year": 2021,
    "current_population": 6302,
    "lga": "Lake Macquarie",
    "lga_growth": {
      "end_population": 219000,
      "end_year": 2025,
      "pct_change": 9,
      "start_population": 201000,
      "start_year": 2015
    },
    "lga_projection": {
      "pct_change": 12.2,
      "source": "MIB",
      "to_year": 2035
    },
    "lga_series": [
      {
        "population": 216983,
        "projected": false,
        "year": 2024
      },
      {
        "population": 219000,
        "projected": false,
        "year": 2025
      },
      {
        "population": 221672,
        "projected": true,
        "year": 2026
      }
    ],
    "microburb_count": 77,
    "suburb": "Belmont North",
    "suburb_growth": {
      "end_population": 6302,
      "end_year": 2021,
      "pct_change": 3.5,
      "start_population": 6086,
      "start_year": 2011
    },
    "suburb_series": [
      {
        "population": 6086,
        "year": 2011
      },
      {
        "population": 6338,
        "year": 2016
      },
      {
        "population": 6302,
        "year": 2021
      }
    ]
  }
}

Changes

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