Compare job demand acrosss geographic areas
GET
/api/v1.1/{country_code}/reports/regional-analysis/demand/For a given geographic area type and criteria, returns the number of unique postings and demand level for all geographic areas of the given type.
This data is commonly used to populate geographic heat maps (chloropleth maps).
:::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.
A unique ID specifying a company/employer.
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.
A unique ID specifying a type of 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
A specific location/statistical area.
The unique ID of the location / statistical area.
The name of the location / statistical area.
The official government code for the location / statistical area.
The unique ID of the location / statistical area type for this location / statistical area.
The unique ID of the country to which this location / statistical area belongs.
The number of unique postings matching the criteria in this location/statistical area.
An indication of whether this number of postings is high, average, or low compared to all locations/statistical areas of the specified type.
[
{
"location": {
"id": 20,
"name": "North East (England)",
"code": "TLC",
"type_id": 20,
"country_id": 1
},
"posting_count": 123,
"posting_count_level": "Low"
}
]