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

Microburbs Property Data API

Australia - Economy

Job advertisements over time

GET/v1/australia/economy/job-vacancies5¢ per call

Monthly count of online job advertisements for Australia and each state and territory since January 2006, by occupation group and by skill level.

Coverage: Australia and all 8 states and territories; monthly, January 2006 to September 2026 (249 months). Current to 2026-09-01. Full description, field list and method: /v1/datasets/job-vacancies.

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.

Query parameters

fieldsstringoptional

Comma-separated subset of: total_ads, managers, professionals, technicians_trades, community_personal_service, clerical_admin, sales, machinery_drivers, labourers, skill_level_1, skill_level_2, skill_level_3, skill_level_4, skill_level_5. 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/australia/economy/job-vacancies

cURL

curl --request GET \
  --url 'https://api.microburbs.com.au/v1/australia/economy/job-vacancies' \
  --header 'Authorization: Bearer test'

Example Responses

Show schema

{
  "data": {
    "dataset": "job-vacancies",
    "level": "australia",
    "area": "australia",
    "period_type": "month",
    "as_of": "2026-09-01",
    "modelled": false,
    "fields": [
      {
        "field": "total_ads",
        "name": "All online job advertisements",
        "unit": "ads",
        "values": [
          {
            "period": "2026-07",
            "period_start": "2026-07-01",
            "value": 209625.5
          },
          {
            "period": "2026-08",
            "period_start": "2026-08-01",
            "value": 210907.6
          },
          {
            "period": "2026-09",
            "period_start": "2026-09-01",
            "value": 211918.7
          }
        ]
      },
      {
        "field": "managers",
        "name": "Job ads: Managers",
        "unit": "ads",
        "values": [
          {
            "period": "2026-07",
            "period_start": "2026-07-01",
            "value": 25428.84
          },
          {
            "period": "2026-08",
            "period_start": "2026-08-01",
            "value": 25563.06
          },
          {
            "period": "2026-09",
            "period_start": "2026-09-01",
            "value": 25692.37
          }
        ]
      },
      {
        "field": "professionals",
        "name": "Job ads: Professionals",
        "unit": "ads",
        "values": [
          {
            "period": "2026-07",
            "period_start": "2026-07-01",
            "value": 60185.31
          },
          {
            "period": "2026-08",
            "period_start": "2026-08-01",
            "value": 60310.16
          },
          {
            "period": "2026-09",
            "period_start": "2026-09-01",
            "value": 60510.01
          }
        ]
      }
    ]
  }
}

Successful Response200

application/json

About this dataset

Australia and all 8 states and territories; monthly, January 2006 to September 2026 (249 months). Current to 2026-09-01; refreshed monthly.

What it is

A monthly count of job advertisements placed online, from January 2006 to the latest month, for Australia as a whole and for each state and territory. It is split by the eight major occupation groups (managers, professionals, technicians and trades workers, community and personal service workers, clerical and administrative workers, sales workers, machinery operators and drivers, labourers) and by five skill levels, plus an all-occupations total.

What it shows

How many vacancies employers are advertising, month by month, in each occupation group and at each skill level. Each period is the first day of the month. The skill-level fields and the occupation fields each add up to the all-occupations total within rounding. A rising count means employers are hiring more; a falling one means demand for workers is cooling.

Why use it

Job advertising is a leading read on the labour market and on housing demand: a surge in tradie, nurse or tech ads brings migration and rental demand to a region before it shows in population or rents. Use it to chart hiring cycles, compare states, spot which occupations are heating up, or add a jobs-demand panel to a state or market report.

How it is built

We take the smoothed (trend) monthly series built from a count of job advertisements on the main online job boards and employer sites, de-duplicated so one vacancy counts once. Counts are advertisements, not vacancies filled or jobs created, and one advertisement can cover several positions. Trend values are revised slightly as new months arrive, and the latest months move most. State figures sum to the national figure to within about two percent because each series is smoothed separately. Skill level 1 is a bachelor degree or higher; level 5 is certificate I or school education. The series is national and state only; it is not available for suburbs or council areas.

Fields

Field	Unit	Description
`total_ads` All online job advertisements	ads	Smoothed monthly count of online job advertisements across all occupations and skill levels in the area.
`managers` Job ads: Managers	ads	Smoothed monthly count of online job advertisements for managers (one of the eight major occupation groups).
`professionals` Job ads: Professionals	ads	Smoothed monthly count of online job advertisements for professionals (one of the eight major occupation groups).
`technicians_trades` Job ads: Technicians and trades workers	ads	Smoothed monthly count of online job advertisements for technicians and trades workers (one of the eight major occupation groups).
`community_personal_service` Job ads: Community and personal service workers	ads	Smoothed monthly count of online job advertisements for community and personal service workers (one of the eight major occupation groups).
`clerical_admin` Job ads: Clerical and administrative workers	ads	Smoothed monthly count of online job advertisements for clerical and administrative workers (one of the eight major occupation groups).
`sales` Job ads: Sales workers	ads	Smoothed monthly count of online job advertisements for sales workers (one of the eight major occupation groups).
`machinery_drivers` Job ads: Machinery operators and drivers	ads	Smoothed monthly count of online job advertisements for machinery operators and drivers (one of the eight major occupation groups).
`labourers` Job ads: Labourers	ads	Smoothed monthly count of online job advertisements for labourers (one of the eight major occupation groups).
`skill_level_1` Job ads: Skill level 1 (bachelor degree or higher)	ads	Smoothed monthly count of online job advertisements for jobs at skill level 1 (bachelor degree or higher). Skill level is the formal education or training normally needed for the job.
`skill_level_2` Job ads: Skill level 2 (advanced diploma or diploma)	ads	Smoothed monthly count of online job advertisements for jobs at skill level 2 (advanced diploma or diploma). Skill level is the formal education or training normally needed for the job.
`skill_level_3` Job ads: Skill level 3 (certificate IV, or III with on-the-job training)	ads	Smoothed monthly count of online job advertisements for jobs at skill level 3 (certificate iv, or iii with on-the-job training). Skill level is the formal education or training normally needed for the job.
`skill_level_4` Job ads: Skill level 4 (certificate II or III)	ads	Smoothed monthly count of online job advertisements for jobs at skill level 4 (certificate ii or iii). Skill level is the formal education or training normally needed for the job.
`skill_level_5` Job ads: Skill level 5 (certificate I or school education)	ads	Smoothed monthly count of online job advertisements for jobs at skill level 5 (certificate i or school education). Skill level is the formal education or training normally needed for the job.