Adzuna Intelligence API
Home
Knowledge Base
About
Adzuna Intelligence API
  • Introduction
  • Access and Authentication
  • Taxonomies
  • Core Demand Data
    • Overview
    • Get the total number of postingsGET
    • Get the total number of postings over timeGET
    • Get the number of new postingsGET
    • Get the number of new postings over timeGET
    • Get posting duration dataGET
    • Get time to fill dataGET
  • Interest Quotient Data
  • Compensation Data
  • Location Data
  • Occupation Data
  • Industry Data
  • Skill Data
  • Education Data
  • Apprenticeship Data
  • Company and Employer Data
  • Public data
  • Complex Queries
logoPowered by Apidog
  1. Core Demand Data

Get posting duration data

GET/api/v1.1/{country_code}/reports/posting-duration/

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

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

Responses

Request successful.(200)
Insufficient data.(204)
Request successful.
HTTP Code: 200
Content Type : JSONapplication/json
Data Schema
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
}
Last modified: 6 months ago