Free sandbox: try any request below on the sample suburbs, no signup. For every suburb, create an API key.

Microburbs Property Data API

Suburb - Area Statistics

Occupation

GET/v1/suburbs/{suburb_name}/area-stats/occupation5¢ per call

What working residents do: managers, professionals, trades, community and personal service, clerical, sales, machinery operators and labourers, as counts and shares of employed residents for every suburb and council area.

Coverage: About 8,800 suburbs and localities and 540 council areas across Australia, in all states and territories (areas with too few people or homes for reliable figures are left out); one snapshot at 10 August 2021. Current to 2021-08-10. Full description, field list and method: /v1/datasets/occupation.

Exact suburb identifier required. Exact official suburb name (SAL), 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.

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

Exact official suburb name (SAL), 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

fieldsstringoptional

Comma-separated subset of: total_employed, managers_count, managers_pct, professionals_count, professionals_pct, technicians_and_trades_count, technicians_and_trades_pct, community_and_personal_service_count, community_and_personal_service_pct, clerical_and_administrative_count, clerical_and_administrative_pct, sales_count, sales_pct, machinery_operators_and_drivers_count, machinery_operators_and_drivers_pct, labourers_count, labourers_pct, occupation_not_stated_count, occupation_not_stated_pct. Omit for all.

fromstringoptional

First period to include: 2020, 2020-Q3, 2020-07 or 2020-07-01.

tostringoptional

Last period to include, same formats as `from`.

Responses

Successful Response

application/json

DatasetValuesfields returned to you

datasetstringalways returned

Dataset slug; describe it with /v1/datasets/{slug}.

levelstringalways returned

suburb, lga or block.

areastringalways returned

Canonical name (or mesh-block code) of the area answered.

period_typestringalways returned

snapshot, year, financial_year, quarter or month.

as_ofstring · datealways returned

Date the dataset is current to. Values are never withheld for age; check this instead.

modelledbooleanalways returned

True when the figures are estimates from a model rather than counts or measurements.

fieldsarray of DatasetFieldSeriesalways returned

GET/v1/suburbs/{suburb_name}/area-stats/occupation

cURL

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

Example Responses

Show schema

{
  "data": {
    "dataset": "occupation",
    "level": "suburb",
    "area": "Bondi",
    "period_type": "snapshot",
    "as_of": "2021-08-10",
    "modelled": false,
    "fields": [
      {
        "field": "total_employed",
        "name": "Employed residents",
        "unit": "persons",
        "values": [
          {
            "period": "2021-08-10",
            "period_start": "2021-08-10",
            "value": 6098
          }
        ]
      },
      {
        "field": "managers_count",
        "name": "Managers",
        "unit": "persons",
        "values": [
          {
            "period": "2021-08-10",
            "period_start": "2021-08-10",
            "value": 1242
          }
        ]
      },
      {
        "field": "managers_pct",
        "name": "Managers: share of employed residents",
        "unit": "%",
        "values": [
          {
            "period": "2021-08-10",
            "period_start": "2021-08-10",
            "value": 20.37
          }
        ]
      }
    ]
  }
}

Successful Response200

application/json

About this dataset

About 8,800 suburbs and localities and 540 council areas across Australia, in all states and territories (areas with too few people or homes for reliable figures are left out); one snapshot at 10 August 2021. Current to 2021-08-10; refreshed five-yearly.

What it is

The occupation of employed residents on 10 August 2021, in the eight major occupation groups, for every suburb and council area. Residents are counted where they live, not where they work.

What it shows

Employed residents by occupation group, each as a head-count and as a share of all employed residents, plus the total employed. Counts and shares are separate fields (for example professionals_count and professionals_pct).

Why use it

Occupation mix is a direct read of a suburb's white-collar or blue-collar character and its income base. Use it to find suburbs dominated by professionals or by tradespeople, to target services and advertising, to judge how exposed an area is to one kind of work, to plan recruitment, or to add a workforce profile to a suburb report. For the industries people work in see employment-by-industry.

How it is built

The base is employed residents aged 15 and over. Shares of the eight groups plus not stated add to about 100. Areas with fewer than 50 employed residents are left out. Our 2021 area statistics, matched to our suburb and council-area names. Figures are a snapshot at 10 August 2021 (the latest full count), so they describe the area then, not today. To protect privacy the source lightly randomises small numbers, so a count of 0, 3 or 6 can be approximate and shares in small areas jump around: check the base field before trusting a percentage. Shares are rounded to two decimals and capped at 100.

Fields

Field	Unit	Description
`total_employed` Employed residents	persons	Employed residents aged 15 and over, the base for every share.
`managers_count` Managers	persons	Number of employed residents whose occupation is: Managers (2021 snapshot). Small counts are lightly randomised for privacy.
`managers_pct` Managers: share of employed residents	%	Managers as a percent of all employed residents in the area.
`professionals_count` Professionals	persons	Number of employed residents whose occupation is: Professionals (2021 snapshot). Small counts are lightly randomised for privacy.
`professionals_pct` Professionals: share of employed residents	%	Professionals as a percent of all employed residents in the area.
`technicians_and_trades_count` Technicians and trades workers	persons	Number of employed residents whose occupation is: Technicians and trades workers (2021 snapshot). Small counts are lightly randomised for privacy.
`technicians_and_trades_pct` Technicians and trades workers: share of employed residents	%	Technicians and trades workers as a percent of all employed residents in the area.
`community_and_personal_service_count` Community and personal service workers	persons	Number of employed residents whose occupation is: Community and personal service workers (2021 snapshot). Small counts are lightly randomised for privacy.
`community_and_personal_service_pct` Community and personal service workers: share of employed residents	%	Community and personal service workers as a percent of all employed residents in the area.
`clerical_and_administrative_count` Clerical and administrative workers	persons	Number of employed residents whose occupation is: Clerical and administrative workers (2021 snapshot). Small counts are lightly randomised for privacy.
`clerical_and_administrative_pct` Clerical and administrative workers: share of employed residents	%	Clerical and administrative workers as a percent of all employed residents in the area.
`sales_count` Sales workers	persons	Number of employed residents whose occupation is: Sales workers (2021 snapshot). Small counts are lightly randomised for privacy.
`sales_pct` Sales workers: share of employed residents	%	Sales workers as a percent of all employed residents in the area.
`machinery_operators_and_drivers_count` Machinery operators and drivers	persons	Number of employed residents whose occupation is: Machinery operators and drivers (2021 snapshot). Small counts are lightly randomised for privacy.
`machinery_operators_and_drivers_pct` Machinery operators and drivers: share of employed residents	%	Machinery operators and drivers as a percent of all employed residents in the area.
`labourers_count` Labourers	persons	Number of employed residents whose occupation is: Labourers (2021 snapshot). Small counts are lightly randomised for privacy.
`labourers_pct` Labourers: share of employed residents	%	Labourers as a percent of all employed residents in the area.
`occupation_not_stated_count` Occupation inadequately described or not stated	persons	Number of employed residents whose occupation is: Occupation inadequately described or not stated (2021 snapshot). Small counts are lightly randomised for privacy.
`occupation_not_stated_pct` Occupation inadequately described or not stated: share of employed residents	%	Occupation inadequately described or not stated as a percent of all employed residents in the area.