Get mean and median salary

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

Returns the mean and median advertised salary for postings matching the given criteria and time period. 10th, 25th, 75th and 90th percentile figures are also provided.

Additionally, the nationwide mean and median advertised salary for all postings nationwide in the given time period is returned for comparison purposes.

The number of postings on which the returned data has been based is also returned.

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

Match pattern:

^[a-z]{2}$

Query Params

category_id

array[integer]

optional

A unique ID specifying an occupation sector/category.

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

Request samples

Responses

Request successful.(200)

Insufficient data.(204)

Request successful.

HTTP Code: 200

Content Type : JSONapplication/json

sample_size

integer

required

The number of postings on which the salary figures given are based.

>= 0

mean_salary

integer

required

The mean advertised salary figure found in postings matching the criteria.

>= 0

median_salary

integer

required

The median advertised salary figure found in postings matching the criteria.

>= 0

national_mean_salary

integer

required

The overall national mean advertised salary in the selected time period.

>= 0

national_median_salary

integer

required

The overall national median advertised salary in the selected time period.

>= 0

percentile_10

integer

required

The 10th percentile advertised salary figure found in postings matching the criteria.

>= 0

percentile_25

integer

required

The 25th percentile advertised salary figure found in postings matching the criteria.

>= 0

percentile_75

integer

required

The 75th percentile advertised salary figure found in postings matching the criteria.

>= 0

percentile_90

integer

required

The 90th percentile advertised salary figure found in postings matching the criteria.

>= 0

{
  "sample_size": 4542,
  "mean_salary": 33791,
  "median_salary": 23621,
  "national_mean_salary": 38312,
  "national_median_salary": 33398,
  "percentile_10": 20687,
  "percentile_25": 21663,
  "percentile_75": 27720,
  "percentile_90": 51574
}

Last modified: 4 months ago