Adzuna Intelligence API
Get companies hiring
GET/api/v1.1/{country_code}/reports/hiring-employers/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
A two character code that specifies which country dataset to query.
A unique ID specifying an occupation sector/category.
The end date of the desired time period for the query. Must be specified in ISO8601 format (YYYY-MM-DD).
A unique ID specifying an industry.
The maximum number of matches to return in a search.
A unique ID specifying a location/statistical area.
A unique ID specifying an occupation (job title). If specified, an occupation_taxonomy_id must also be provided.
A unique ID specifying an occupation taxonomy. Required when specifying an occupation_id.
A unique ID specifying a skill.
A unique ID specifying a skill tag (pre-defined group of skills).
The start date of the desired time period for the query. Must be specified in ISO8601 format (YYYY-MM-DD).
Request samples
Responses
The number of postings matching your criteria, where we were able to identify the end employer.
An array of companies.
The industry that the company belongs to.
The number of unique postings by the company that match the given criteria.
{
"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
}
]
}