Get posting duration data

GET

https://api.intelligence.adzuna.com/api/v1.1/{country_code}/reports/posting-duration/

Core Demand Data

For the given criteria and time period, returns information about how long (in days) postings matching the criteria remained live on the Adzuna website.

In addition to the median (50th percentile) figure, we also return 25th and 75th percentile figures, together with a minimum and maximum figure.

To reduce the effect of statistical outliers, for minimum and maximum values, we consider the 5th and 99th percentiles (respectively), and additionally do not consider postings that were seen for less than 14 days.

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

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.

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.

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

curl --location --request GET 'https://api.intelligence.adzuna.com/api/v1.1/gb/reports/posting-duration/?category_id&company_id&end_date=2022-01-31&industry_id&location_id=26&occupation_id&occupation_taxonomy_id&skill_id&start_date=2022-01-01' \
--header 'Authorization;'

Responses

🟢200Request successful.

application/json

Body

duration_min

integer

required

The minimum (5th percentile) number of days that matching postings were live.

>= 7

duration_percentile_25

integer

required

The 25th percentile number of days that matching postings were live.

>= 7

duration_percentile_50

integer

required

The median (50th percentile) number of days that matching postings were live.

>= 7

duration_percentile_75

integer

required

The 75th percentile number of days that matching postings were live.

>= 7

duration_max

integer

required

The maximum (95th percentile) number of days that matching postings were live.

>= 7

Example

{
  "ttf_min": 21,
  "ttf_percentile_25": 24,
  "ttf_percentile_50": 27,
  "ttf_percentile_75": 35,
  "ttf_max": 169
}

🟢204Insufficient data.

Get the number of new postings over time

Get time to fill data