Adzuna Intelligence API
HomeKnowledge BaseAbout
HomeKnowledge BaseAbout
  1. Complex Queries
  • Introduction
  • Access and Authentication
  • Taxonomies
  • Core Demand Data
    • Overview
    • Get the total number of postings
      GET
    • Get the total number of postings over time
      GET
    • Get the number of new postings
      GET
    • Get the number of new postings over time
      GET
    • Get posting duration data
      GET
    • Get time to fill data
      GET
  • Interest Quotient Data
    • Overview
    • Get interest quotient
      GET
    • Get interest quotient over time
      GET
  • Compensation Data
    • List job benefits
      GET
    • Search job benefits
      GET
    • Get mean and median salary
      GET
    • Get mean and median salary over time
      GET
    • Get salary distribution data
      GET
    • Get benefits offered
      GET
  • Location Data
    • List countries
    • List location (statistical area) types
    • List locations (statistical areas)
    • Search locations (statistical areas)
    • Get location quotient
    • Compare job demand acrosss geographic areas
    • Compare interest quotient across geographic areas
    • Compare location quotient across geographic areas
    • Compare median salary across geographic areas
  • Occupation Data
    • List occupation taxonomies
    • List occupation sectors (categories)
    • Search occupation sectors (categories)
    • List occupations
    • Search occupations
    • Get occupation sectors (categories) in demand
    • Get occupations in demand
    • Get popular occupation sectors (categories)
    • Get popular occupations
  • Industry Data
    • List industries
    • Search industries
    • Get industries hiring
    • Get popular industries
  • Skill Data
    • List skill taxonomies
    • List skill tags
    • Search skill tags
    • List skills
    • Search skills
    • Get requested skills
  • Education Data
    • List education levels
    • Search education levels
    • List education qualifications
    • Search education qualifications
    • Get requested education attainment
  • Apprenticeship Data
    • List apprenticeship levels
    • Search apprenticeship levels
    • List apprenticeship types
    • Search apprenticeship types
    • Get requested apprenticeship levels
  • Company and Employer Data
    • List companies
    • Search companies
    • Get companies hiring
    • Get popular employers
  • Public data
    • Claimant count
    • Gender pay gap
    • Job Density
  • Complex Queries
    • Overview
    • Defining a query
    • Specifying the primary metric
    • Specifying a date range
    • Supported dimensions
    • Specifying filters
    • Specifying a breakdown
    • Example queries
    • Performing a complex boolean query
      POST
  1. Complex Queries

Defining a query

The desired query is passed to the endpoint as a JSON object in the body of the request.

The ComplexQueryRequest object#

The ComplexQueryRequest object encapsulates the desired query and is passed as a JSON object in the body of the request.
ComplexQueryRequest
metric
enum<string> 
required
The metric to be reported.
Allowed values:
demandsalary
date_range
required
The date range to be used for the report.
One of
type
enum<string> 
required
Specifies the date range as absolute.
Allowed value:
absolute
start
string <date>
required
The start date for the date range in ISO8601 format (YYYY-MM-DD).
Example:
2023-07-19
Match pattern:
^([0-9]{4})(-?)(1[0-2]|0[1-9])\2(3[01]|0[1-9]|[12][0-9])$
end
string <date>
required
The end date for the date range in ISO8601 format (YYYY-MM-DD).
Example:
2024-07-22
Match pattern:
^([0-9]{4})(-?)(1[0-2]|0[1-9])\2(3[01]|0[1-9]|[12][0-9])$
filter
optional
Specifies the filtering to apply to the query.
One of
type
enum<string> 
required
Specifies that this is a rule.
Allowed value:
rule
dimension
enum<string> 
required
The dimension (facet) on which to filter.
Allowed values:
apprenticeship_levelapprenticeship_typecategorycompanycontract_hourscontract_typeeducation_levelindustrylocationoccupationqualificationsalaryseniorityskillskill_tagworkplace_modelyears_of_experience
operator
enum<string> 
required
The operator to apply when filtering.
Allowed values:
eqneqgteltegtltanynone
target
required
The filter target type. The type of target depends on the selected dimension.
taxonomy_id
integer 
optional
If the dimension is occupation or skill, a taxonomy ID is required.
breakdown
object (Breakdown) 
optional
Specifies whether the output should be broken down by a specific dimension.
dimension
enum<string> 
required
The dimension (facet) by which to breakdown the results..
Allowed values:
apprenticeship_levelapprenticeship_typecategorycompanycontract_hourscontract_typeeducation_levelindustrylocationoccupationqualificationsalaryseniorityskillskill_tagworkplace_modelyears_of_experience
taxonomy_id
integer 
optional
If the breakdown dimension is occupation or skill, a taxonomy ID is required.
location_type_id
integer 
optional
If the breakdown dimension is location, a location type ID must be provided.

The ComplexQueryResponse object#

The results of a query are returned in a ComplexQueryResponse object.
ComplexQueryResponse
metric
enum<string> 
required
Specifies which metric (demand or salary) the query was based on.
Allowed values:
demandsalary
key_metrics
object (MetricValue) 
required
The aggregated value of the selected metric over the selected date range and filtered by the given rules. Only present if no breakdown dimension was specified in the query.
metric_value
required
An object containing the type and value of the metric.
breakdown_dimension
enum<string> 
required
The dimension (facet) by which the results have been broken down.
Allowed values:
apprenticeship_levelapprenticeship_typecategorycompanycontract_hourscontract_typeeducation_levelindustrylocationoccupationqualificationsalaryseniorityskillskill_tagworkplace_modelyears_of_experience
breakdown
array[object (BreakdownResult) {2}] 
required
Each object in the array represents the aggregated value of the selected metric, for each result in a breakdown. Only present if a breakdown dimension was specified in the query.
metric_value
required
An object containing the type and value of the metric.
breakdown_value
object (BreakdownValue) 
required
An object specifying the a single instance of the breakdown facet.
raw
array[object (RawData) {3}] 
required
Each object in the array represents the metric value at a (weekly) point in time in the selected date range. If a breakdown dimension was specified in the query, there may be multiple RawDataObjects for each date, one for each result in the breakdown. The data in this field can be used to plot time series charts.
date
string <date-time>
required
A date-time in ISO 8601 format.
metric_value
required
The value of the metric.
breakdown_value
object (BreakdownValue) 
required
The instance of the breakdown dimension (if specified).
Previous
Overview
Next
Specifying the primary metric
Built with