Get occupations in demand - Adzuna Intelligence API

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

Add parameter in header

Authorization

Example:

Authorization: ********************

Path Params

country_code

string

required

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

Example:

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:

location_id

array[integer]

required

A unique ID specifying a location/statistical area.

Example:

occupation_taxonomy_id

integer

required

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

>= 1

Example:

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

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Request successful.

application/json

Body

array of:

occupation

object

read-onlyrequired

An occupation.

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
  }
]