Adzuna Intelligence API
Home
Knowledge Base
About
Adzuna Intelligence API
  • Introduction
  • Access and Authentication
  • Taxonomies
  • Core Demand Data
  • Interest Quotient Data
  • Compensation Data
    • List job benefitsGET
    • Search job benefitsGET
    • Get mean and median salaryGET
    • Get mean and median salary over timeGET
    • Get salary distribution dataGET
    • Get benefits offeredGET
  • Location Data
  • Occupation Data
  • Industry Data
  • Skill Data
  • Education Data
  • Apprenticeship Data
  • Company and Employer Data
  • Public data
  • Complex Queries
logoPowered by Apidog
  1. Compensation Data

Get salary distribution data

GET/api/v1.1/{country_code}/reports/salary-distribution/

For postings matching the given criteria and time period, returns the salary distribution in terms of advertised salary against number of postings.

Salary values are in 5,000 brackets (of the applicable currency).

This data is useful for generating histograms of salary distribution.

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

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

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

Responses

Request successful.(200)
Insufficient data.(204)
Request successful.
HTTP Code: 200
Content Type : JSONapplication/json
Data Schema
array of:
salary_min
integer 
required

The lower value of the salary bracket.

>= 0
salary_max
integer 
required

The upper value of the salary bracket.

>= 0
posting_count
integer 
required

The number of postings with an advertised salary falling within this salary bracket.

>= 0
Example
[
  {
    "salary_min": 35000,
    "salary_max": 40000,
    "posting_count": 123
  }
]
Last modified: 4 months ago