List companies
GET
/api/v1.1/{country_code}/companies/Returns a paginated list of all recognised companies (employers).
Example uses for this data include populating a dropdown in a user interface.
Request
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
page
integer
optional
A specific page of results to return from a paginated dataset.
Default:
1
page_size
integer
optional
The number of results to include per page, from a paginated dataset.
Default:
5
Request samples
Responses
Request successful.(200)
Request successful.
HTTP Code: 200
Content Type : JSONapplication/json
Data Schema
count
integer
optional
The total number of results in the underlying dataset.
Example:
1
next
string <uri> | null
optional
The URL to retrieve the next page of results.
Example:
https://api.intelligence.adzuna.com/api/v1.1/gb/companies/?page=4
previous
string <uri> | null
optional
The URL to retrieve the previous page of results.
Example:
https://api.intelligence.adzuna.com/api/v1.1/gb/companies/?page=2
results
array[object (CompanySerializerWithIndustry) {5}]
optional
An array of companies.
id
integer
required
The unique ID of the company.
>= 1<= 2147483647
Example:
31381
name
string
required
The name of the company.
<= 256 characters
Example:
Adzuna
description
string | null
optional
A description of the company.
country_id
integer
read-onlyrequired
The unique ID of the country in which the company primarily operates.
>= 1<= 2147483647
Example:
1
industry
object (SIC)
required
The industry in which the company operates.
Example
{
"count": 1,
"next": "https://api.intelligence.adzuna.com/api/v1.1/gb/companies/?page=4",
"previous": "https://api.intelligence.adzuna.com/api/v1.1/gb/companies/?page=2",
"results": [
{
"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"
}
}
]
}
Last modified: 4 months ago