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

Microburbs Property Data API

Suburb - Economy

Employment by industry and occupation

GET/v1/suburbs/{suburb_name}/economy/employment-by-industry10¢ per call

What employed residents do for a living: head-counts and shares across 19 industries and 8 occupation groups, for every suburb and council area.

Coverage: About 8,800 suburbs and localities and 540 council areas across Australia (areas with fewer than 50 employed residents are left out); one snapshot at 10 August 2021. Current to 2021-08-10. Full description, field list and method: /v1/datasets/employment-by-industry.

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: employed_residents, ind_agriculture_forestry_fishing_count, ind_agriculture_forestry_fishing_pct, ind_mining_count, ind_mining_pct, ind_manufacturing_count, ind_manufacturing_pct, ind_utilities_count, ind_utilities_pct, ind_construction_count, ind_construction_pct, ind_wholesale_trade_count, ind_wholesale_trade_pct, ind_retail_trade_count, ind_retail_trade_pct, ind_accommodation_food_count, ind_accommodation_food_pct, ind_transport_postal_warehousing_count, ind_transport_postal_warehousing_pct, ind_media_telecommunications_count, ind_media_telecommunications_pct, ind_finance_insurance_count, ind_finance_insurance_pct, ind_rental_hiring_real_estate_count, ind_rental_hiring_real_estate_pct, ind_professional_scientific_technical_count, ind_professional_scientific_technical_pct, ind_administrative_support_count, ind_administrative_support_pct, ind_public_administration_safety_count, ind_public_administration_safety_pct, ind_education_training_count, ind_education_training_pct, ind_health_care_social_assistance_count, ind_health_care_social_assistance_pct, ind_arts_recreation_count, ind_arts_recreation_pct, ind_other_services_count, ind_other_services_pct, ind_industry_not_stated_count, ind_industry_not_stated_pct, occ_managers_count, occ_managers_pct, occ_professionals_count, occ_professionals_pct, occ_technicians_trades_count, occ_technicians_trades_pct, occ_community_personal_service_count, occ_community_personal_service_pct, occ_clerical_admin_count, occ_clerical_admin_pct, occ_sales_count, occ_sales_pct, occ_machinery_drivers_count, occ_machinery_drivers_pct, occ_labourers_count, occ_labourers_pct, occ_occupation_not_stated_count, occ_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}/economy/employment-by-industry

cURL

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

Example Responses

Show schema

{
  "data": {
    "dataset": "employment-by-industry",
    "level": "suburb",
    "area": "Bondi",
    "period_type": "snapshot",
    "as_of": "2021-08-10",
    "modelled": false,
    "fields": [
      {
        "field": "employed_residents",
        "name": "Employed residents",
        "unit": "persons",
        "values": [
          {
            "period": "2021-08-10",
            "period_start": "2021-08-10",
            "value": 6098
          }
        ]
      },
      {
        "field": "ind_agriculture_forestry_fishing_count",
        "name": "Industry: Agriculture, forestry and fishing: residents",
        "unit": "persons",
        "values": [
          {
            "period": "2021-08-10",
            "period_start": "2021-08-10",
            "value": 8
          }
        ]
      },
      {
        "field": "ind_agriculture_forestry_fishing_pct",
        "name": "Industry: Agriculture, forestry and fishing: share of employed residents",
        "unit": "%",
        "values": [
          {
            "period": "2021-08-10",
            "period_start": "2021-08-10",
            "value": 0.13
          }
        ]
      }
    ]
  }
}

Successful Response200

application/json

About this dataset

About 8,800 suburbs and localities and 540 council areas across Australia (areas with fewer than 50 employed residents are left out); one snapshot at 10 August 2021. Current to 2021-08-10; refreshed five-yearly.

What it is

The industry and occupation of employed residents aged 15 and over on 10 August 2021, for every suburb and council area in Australia. There are 19 industries (agriculture through to other services, plus a not-stated group) and 8 occupation groups (managers through to labourers, plus a not-stated group). Every group is a pair of fields: a head-count and a share of employed residents. A single employed_residents field gives the base.

What it shows

Where residents work (by industry of their main job) and what they do (by occupation), as counts and as a percent of employed residents. Industry and occupation each sum to the employed total, so you can recompute any share. Counts are of residents by home area, not of jobs located in the area.

Why use it

The jobs profile of an area drives incomes, housing demand and resilience: a suburb of mining and construction workers behaves differently from one of health and education professionals. Use it to find suburbs dominated by one industry, to size a trade-services or professional-services market, to judge exposure to a single employer or sector, to target a campaign by occupation, or to add an economy section to a suburb report. For earnings by occupation see taxpayer-occupation; for current job demand see job-vacancies.

How it is built

Our 2021 area statistics, matched to our suburb and council-area names. Areas with fewer than 50 employed residents are left out because every small number is randomised. Figures are a snapshot at 10 August 2021 (the latest full count), so they describe the workforce then, not today. The source lightly randomises small numbers, so a count of 0, 3 or 6 can be approximate and shares for small areas jump around; check employed_residents before trusting a percentage. Industry follows the national industry classification at division level (19 divisions) and occupation the major groups of the national occupation classification. The not-stated groups hold people who gave an unclear answer or none. Industry and occupation shares are each out of all employed residents.

Fields

Field	Unit	Description
`employed_residents` Employed residents	persons	All employed residents aged 15 and over counted in the area on 10 August 2021 (people at work or temporarily away from a job), the base for every share in this dataset.
`ind_agriculture_forestry_fishing_count` Industry: Agriculture, forestry and fishing: residents	persons	Number of employed residents who work in agriculture, forestry and fishing (2021 snapshot). Counts the industry of the person's main job, wherever the job is; it is where residents work, not where jobs are located. Small counts are lightly randomised for privacy.
`ind_agriculture_forestry_fishing_pct` Industry: Agriculture, forestry and fishing: share of employed residents	%	Employed residents in this industry as a percent of all employed residents of the area.
`ind_mining_count` Industry: Mining: residents	persons	Number of employed residents who work in mining (2021 snapshot). Counts the industry of the person's main job, wherever the job is; it is where residents work, not where jobs are located. Small counts are lightly randomised for privacy.
`ind_mining_pct` Industry: Mining: share of employed residents	%	Employed residents in this industry as a percent of all employed residents of the area.
`ind_manufacturing_count` Industry: Manufacturing: residents	persons	Number of employed residents who work in manufacturing (2021 snapshot). Counts the industry of the person's main job, wherever the job is; it is where residents work, not where jobs are located. Small counts are lightly randomised for privacy.
`ind_manufacturing_pct` Industry: Manufacturing: share of employed residents	%	Employed residents in this industry as a percent of all employed residents of the area.
`ind_utilities_count` Industry: Electricity, gas, water and waste services: residents	persons	Number of employed residents who work in electricity, gas, water and waste services (2021 snapshot). Counts the industry of the person's main job, wherever the job is; it is where residents work, not where jobs are located. Small counts are lightly randomised for privacy.
`ind_utilities_pct` Industry: Electricity, gas, water and waste services: share of employed residents	%	Employed residents in this industry as a percent of all employed residents of the area.
`ind_construction_count` Industry: Construction: residents	persons	Number of employed residents who work in construction (2021 snapshot). Counts the industry of the person's main job, wherever the job is; it is where residents work, not where jobs are located. Small counts are lightly randomised for privacy.
`ind_construction_pct` Industry: Construction: share of employed residents	%	Employed residents in this industry as a percent of all employed residents of the area.
`ind_wholesale_trade_count` Industry: Wholesale trade: residents	persons	Number of employed residents who work in wholesale trade (2021 snapshot). Counts the industry of the person's main job, wherever the job is; it is where residents work, not where jobs are located. Small counts are lightly randomised for privacy.
`ind_wholesale_trade_pct` Industry: Wholesale trade: share of employed residents	%	Employed residents in this industry as a percent of all employed residents of the area.
`ind_retail_trade_count` Industry: Retail trade: residents	persons	Number of employed residents who work in retail trade (2021 snapshot). Counts the industry of the person's main job, wherever the job is; it is where residents work, not where jobs are located. Small counts are lightly randomised for privacy.
`ind_retail_trade_pct` Industry: Retail trade: share of employed residents	%	Employed residents in this industry as a percent of all employed residents of the area.
`ind_accommodation_food_count` Industry: Accommodation and food services: residents	persons	Number of employed residents who work in accommodation and food services (2021 snapshot). Counts the industry of the person's main job, wherever the job is; it is where residents work, not where jobs are located. Small counts are lightly randomised for privacy.
`ind_accommodation_food_pct` Industry: Accommodation and food services: share of employed residents	%	Employed residents in this industry as a percent of all employed residents of the area.
`ind_transport_postal_warehousing_count` Industry: Transport, postal and warehousing: residents	persons	Number of employed residents who work in transport, postal and warehousing (2021 snapshot). Counts the industry of the person's main job, wherever the job is; it is where residents work, not where jobs are located. Small counts are lightly randomised for privacy.
`ind_transport_postal_warehousing_pct` Industry: Transport, postal and warehousing: share of employed residents	%	Employed residents in this industry as a percent of all employed residents of the area.
`ind_media_telecommunications_count` Industry: Information media and telecommunications: residents	persons	Number of employed residents who work in information media and telecommunications (2021 snapshot). Counts the industry of the person's main job, wherever the job is; it is where residents work, not where jobs are located. Small counts are lightly randomised for privacy.
`ind_media_telecommunications_pct` Industry: Information media and telecommunications: share of employed residents	%	Employed residents in this industry as a percent of all employed residents of the area.
`ind_finance_insurance_count` Industry: Financial and insurance services: residents	persons	Number of employed residents who work in financial and insurance services (2021 snapshot). Counts the industry of the person's main job, wherever the job is; it is where residents work, not where jobs are located. Small counts are lightly randomised for privacy.
`ind_finance_insurance_pct` Industry: Financial and insurance services: share of employed residents	%	Employed residents in this industry as a percent of all employed residents of the area.
`ind_rental_hiring_real_estate_count` Industry: Rental, hiring and real estate services: residents	persons	Number of employed residents who work in rental, hiring and real estate services (2021 snapshot). Counts the industry of the person's main job, wherever the job is; it is where residents work, not where jobs are located. Small counts are lightly randomised for privacy.
`ind_rental_hiring_real_estate_pct` Industry: Rental, hiring and real estate services: share of employed residents	%	Employed residents in this industry as a percent of all employed residents of the area.
`ind_professional_scientific_technical_count` Industry: Professional, scientific and technical services: residents	persons	Number of employed residents who work in professional, scientific and technical services (2021 snapshot). Counts the industry of the person's main job, wherever the job is; it is where residents work, not where jobs are located. Small counts are lightly randomised for privacy.
`ind_professional_scientific_technical_pct` Industry: Professional, scientific and technical services: share of employed residents	%	Employed residents in this industry as a percent of all employed residents of the area.
`ind_administrative_support_count` Industry: Administrative and support services: residents	persons	Number of employed residents who work in administrative and support services (2021 snapshot). Counts the industry of the person's main job, wherever the job is; it is where residents work, not where jobs are located. Small counts are lightly randomised for privacy.
`ind_administrative_support_pct` Industry: Administrative and support services: share of employed residents	%	Employed residents in this industry as a percent of all employed residents of the area.
`ind_public_administration_safety_count` Industry: Public administration and safety: residents	persons	Number of employed residents who work in public administration and safety (2021 snapshot). Counts the industry of the person's main job, wherever the job is; it is where residents work, not where jobs are located. Small counts are lightly randomised for privacy.
`ind_public_administration_safety_pct` Industry: Public administration and safety: share of employed residents	%	Employed residents in this industry as a percent of all employed residents of the area.
`ind_education_training_count` Industry: Education and training: residents	persons	Number of employed residents who work in education and training (2021 snapshot). Counts the industry of the person's main job, wherever the job is; it is where residents work, not where jobs are located. Small counts are lightly randomised for privacy.
`ind_education_training_pct` Industry: Education and training: share of employed residents	%	Employed residents in this industry as a percent of all employed residents of the area.
`ind_health_care_social_assistance_count` Industry: Health care and social assistance: residents	persons	Number of employed residents who work in health care and social assistance (2021 snapshot). Counts the industry of the person's main job, wherever the job is; it is where residents work, not where jobs are located. Small counts are lightly randomised for privacy.
`ind_health_care_social_assistance_pct` Industry: Health care and social assistance: share of employed residents	%	Employed residents in this industry as a percent of all employed residents of the area.
`ind_arts_recreation_count` Industry: Arts and recreation services: residents	persons	Number of employed residents who work in arts and recreation services (2021 snapshot). Counts the industry of the person's main job, wherever the job is; it is where residents work, not where jobs are located. Small counts are lightly randomised for privacy.
`ind_arts_recreation_pct` Industry: Arts and recreation services: share of employed residents	%	Employed residents in this industry as a percent of all employed residents of the area.
`ind_other_services_count` Industry: Other services: residents	persons	Number of employed residents who work in other services (2021 snapshot). Counts the industry of the person's main job, wherever the job is; it is where residents work, not where jobs are located. Small counts are lightly randomised for privacy.
`ind_other_services_pct` Industry: Other services: share of employed residents	%	Employed residents in this industry as a percent of all employed residents of the area.
`ind_industry_not_stated_count` Industry: Industry not stated or inadequately described: residents	persons	Number of employed residents who work in industry not stated or inadequately described (2021 snapshot). Counts the industry of the person's main job, wherever the job is; it is where residents work, not where jobs are located. Small counts are lightly randomised for privacy.
`ind_industry_not_stated_pct` Industry: Industry not stated or inadequately described: share of employed residents	%	Employed residents in this industry as a percent of all employed residents of the area.
`occ_managers_count` Occupation: Managers: residents	persons	Number of employed residents whose main job is in the occupation group managers (2021 snapshot). Small counts are lightly randomised for privacy.
`occ_managers_pct` Occupation: Managers: share of employed residents	%	Employed residents in this occupation group as a percent of all employed residents of the area.
`occ_professionals_count` Occupation: Professionals: residents	persons	Number of employed residents whose main job is in the occupation group professionals (2021 snapshot). Small counts are lightly randomised for privacy.
`occ_professionals_pct` Occupation: Professionals: share of employed residents	%	Employed residents in this occupation group as a percent of all employed residents of the area.
`occ_technicians_trades_count` Occupation: Technicians and trades workers: residents	persons	Number of employed residents whose main job is in the occupation group technicians and trades workers (2021 snapshot). Small counts are lightly randomised for privacy.
`occ_technicians_trades_pct` Occupation: Technicians and trades workers: share of employed residents	%	Employed residents in this occupation group as a percent of all employed residents of the area.
`occ_community_personal_service_count` Occupation: Community and personal service workers: residents	persons	Number of employed residents whose main job is in the occupation group community and personal service workers (2021 snapshot). Small counts are lightly randomised for privacy.
`occ_community_personal_service_pct` Occupation: Community and personal service workers: share of employed residents	%	Employed residents in this occupation group as a percent of all employed residents of the area.
`occ_clerical_admin_count` Occupation: Clerical and administrative workers: residents	persons	Number of employed residents whose main job is in the occupation group clerical and administrative workers (2021 snapshot). Small counts are lightly randomised for privacy.
`occ_clerical_admin_pct` Occupation: Clerical and administrative workers: share of employed residents	%	Employed residents in this occupation group as a percent of all employed residents of the area.
`occ_sales_count` Occupation: Sales workers: residents	persons	Number of employed residents whose main job is in the occupation group sales workers (2021 snapshot). Small counts are lightly randomised for privacy.
`occ_sales_pct` Occupation: Sales workers: share of employed residents	%	Employed residents in this occupation group as a percent of all employed residents of the area.
`occ_machinery_drivers_count` Occupation: Machinery operators and drivers: residents	persons	Number of employed residents whose main job is in the occupation group machinery operators and drivers (2021 snapshot). Small counts are lightly randomised for privacy.
`occ_machinery_drivers_pct` Occupation: Machinery operators and drivers: share of employed residents	%	Employed residents in this occupation group as a percent of all employed residents of the area.
`occ_labourers_count` Occupation: Labourers: residents	persons	Number of employed residents whose main job is in the occupation group labourers (2021 snapshot). Small counts are lightly randomised for privacy.
`occ_labourers_pct` Occupation: Labourers: share of employed residents	%	Employed residents in this occupation group as a percent of all employed residents of the area.
`occ_occupation_not_stated_count` Occupation: Occupation not stated or inadequately described: residents	persons	Number of employed residents whose main job is in the occupation group occupation not stated or inadequately described (2021 snapshot). Small counts are lightly randomised for privacy.
`occ_occupation_not_stated_pct` Occupation: Occupation not stated or inadequately described: share of employed residents	%	Employed residents in this occupation group as a percent of all employed residents of the area.