For postings matching the given criteria and time period, returns a list of companies (employers), ranked in order of number of job postings.
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:
gb
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.
limit
integer
optional
The maximum number of matches to return in a search.
>= 1<= 1000
Default:
10
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
Request samples
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl--location--request GET 'https://api.intelligence.adzuna.com/api/v1.1/gb/reports/hiring-employers/?category_id&end_date=2022-01-31&industry_id&limit&location_id=26&occupation_id&occupation_taxonomy_id&skill_id&skill_tag_id&start_date=2022-01-01'
Responses
🟢200Request successful.
application/json
Body
sample_size
integer
required
The number of postings matching your criteria, where we were able to identify the end employer.
>= 0
data
array[object (InDemandCompaniesOutput) {3}]
required
An array of companies.
industry
object
read-onlyrequired
The industry that the company belongs to.
company
object(Company)
required
posting_count
integer
required
The number of unique postings by the company that match the given criteria.
>= 0
Example
{"sample_size":36894,"data":[{"company":{"id":31381,"name":"Adzuna","description":"Adzuna is a next-generation search engine for classified ads used by [...]","country_id":1},"industry":{"id":"J","label":"Information and communication","description":"Information and communication"},"posting_count":123}]}
