Adzuna Intelligence API
Home
Knowledge Base
About
Adzuna Intelligence API
  • Introduction
  • Access and Authentication
  • Taxonomies
  • Core Demand Data
  • Interest Quotient Data
  • Compensation Data
  • Location Data
  • Occupation Data
    • List occupation taxonomiesGET
    • List occupation sectors (categories)GET
    • Search occupation sectors (categories)GET
    • List occupationsGET
    • Search occupationsGET
    • Get occupation sectors (categories) in demandGET
    • Get occupations in demandGET
    • Get popular occupation sectors (categories)GET
    • Get popular occupationsGET
  • Industry Data
  • Skill Data
  • Education Data
  • Apprenticeship Data
  • Company and Employer Data
  • Public data
  • Complex Queries
logoPowered by Apidog
  1. Occupation Data

Get occupations in demand

GET/api/v1.1/{country_code}/reports/hiring-occupations/

For postings matching the given criteria and time period, returns a list of occupations, ranked in order of number of postings.

:::info
This endpoint allows querying by one primary facet type (location, occupation, skill, industry, employer) only. Multiple values of the same facet may be provided, in which case, they will be aggregated.

For more complex queries over multiple facets, see Perform complex boolean queries
:::

Request

Authorization: API Key
Add parameter in header
Authorization
Example
Authorization: 2f68dbbf-519d-4f01-9636-e2421b68f379
Path Params
country_code
string 
required

A two character code that specifies which country dataset to query.

Example:
gb
Match pattern:
^[a-z]{2}$
Query Params
category_id
array[integer]
optional

A unique ID specifying an occupation sector/category.

end_date
string <date>
required

The end date of the desired time period for the query. Must be specified in ISO8601 format (YYYY-MM-DD).

Example:
2022-01-31
industry_id
array[string]
optional

A unique ID specifying an industry.

limit
integer 
optional

The maximum number of matches to return in a search.

>= 1<= 1000
Default:
10
location_id
array[integer]
required

A unique ID specifying a location/statistical area.

Example:
26
occupation_taxonomy_id
integer 
required

A unique ID specifying an occupation taxonomy. Required when specifying an occupation_id.

>= 1
Example:
1
skill_id
array[integer]
optional

A unique ID specifying a skill.

start_date
string <date>
required

The start date of the desired time period for the query. Must be specified in ISO8601 format (YYYY-MM-DD).

Example:
2022-01-01

Request samples

Responses

Request successful.(200)
Request successful.
HTTP Code: 200
Content Type : JSONapplication/json
Data Schema
array of:
occupation
object 
read-onlyrequired

An occupation.

id
integer 
required

The unique ID of the occupation.

>= -2147483648<= 2147483647
name
string 
required

The name of the occupation.

<= 128 characters
posting_count
integer 
required

The number of postings for jobs in this occupation.

>= 0
Example
[
  {
    "occupation": {
      "id": 26295,
      "name": "1st Assistant Manager"
    },
    "posting_count": 123
  }
]
Last modified: 5 months ago