Get the total number of postings

GET

https://api.intelligence.adzuna.com/api/v1.1/{country_code}/reports/demand/

Core Demand Data

Returns the total number of unique, deduplicated postings seen on the Adzuna website for the given criteria over the given time period.

In addition to the number (returned as posting_count), an high/average/low indication is returned (posting_count_level). This indicates whether the number is high, medium or low compared to the average across all values of the primary facet, in the given location and time period.

For example, if you query the demand figure for a particular occupation, and the value of posting_count_level is "High", this means that the number of postings for this particular occupation is high compared to the average for all occupations in the given location and time period.

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.

company_id

array[integer]

optional

A unique ID specifying a company/employer.

contract_hours

enum<string>

optional

If specified, limits the query to postings for full-time or part-time jobs.

>= 1 characters

Allowed values:

full_timepart_time

contract_type

enum<string>

optional

If specified, limits the query to postings for permanent or contract jobs.

>= 1 characters

Allowed values:

contractpermanent

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.

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

workplace_model

enum<string>

optional

If specified, limits the query to postings for remote-only, on-site or flexible/hybrid jobs.

>= 1 characters

Allowed values:

not_remoteremote_onlyflexible

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET 'https://api.intelligence.adzuna.com/api/v1.1/gb/reports/demand/?category_id&company_id&contract_hours&contract_type&end_date=2022-01-31&industry_id&location_id=26&occupation_id&occupation_taxonomy_id&skill_id&skill_tag_id&start_date=2022-01-01&workplace_model'

Responses

🟢200Request successful.

application/json

Body

posting_count

integer

required

The absolute number of postings matching the query.

>= 0

posting_count_level

enum<string>

required

Specifies whether the number of postings is high, average or low compared to the average across the primary facet.

Allowed values:

LowAverageHigh

Example

{
  "posting_count": 0,
  "posting_count_level": "Low"
}

Modified at 2024-07-18 11:42:26

Overview

Get the total number of postings over time