Get popular occupation sectors (categories)

GET/api/v1.1/{country_code}/reports/popular-categories/

For postings matching the given criteria and time period, returns a list of occupation sectors, ranked in order of interest quotient (popularity with jobseekers on the Adzuna website).

:::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.
:::

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:

Match pattern:

^[a-z]{2}$

Query Params

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_id

array[integer]

optional

A unique ID specifying an occupation (job title). If specified, an occupation_taxonomy_id must also be provided.

occupation_taxonomy_id

integer

optional

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

>= 1

skill_id

array[integer]

optional

A unique ID specifying a skill.

skill_tag_id

array[integer]

optional

A unique ID specifying a skill tag (pre-defined group of skills).

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

A list of occupation sectors (categories).

array of:

category

object (Category)

required

An occupation sector (category).

integer

required

The unique ID of the occupation sector (category).

>= -32768<= 32767

label

string

required

The name of the occupation sector (category).

<= 45 characters

description

string

required

A description of the occupation sector (category).

<= 45 characters

interest_quotient

number <double>

required

The interest quotient for this occupation sector (category).

[
  {
    "category": {
      "id": 1,
      "label": "Accounting & Finance Jobs",
      "description": "Accounting / Finance"
    },
    "interest_quotient": 1.23
  }
]

Last modified: 5 months ago