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

Specifying a date range

The date_range parameter allows you to limit your query to postings that were live in a certain time period.
A date range may be absolute ie. between date X and date Y, or it may be relative to today's date.

Absolute date range#

To use an absolute date range, pass an AbsoluteDateRange object in the date_range parameter.
AbsoluteDateRange
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])$

Example#

Specify a date range limited to the month of March in 2024:
"date_range": {
    "type": "absolute",
    "start": "2024-03-01",
    "end": "2024-03-31"
}

Relative date range#

To use a relative date range, pass a RelativeDateRange object in the date_range parameter.
RelativeDateRange
type
enum<string> 
required
Specifies the date range is relative.
Allowed value:
relative
last_n_days
integer 
required
The time interval (measured backwards from the current date).
Example:
30

Example#

Specify a date range covering the last 30 days:
"date_range": {
    "type": "relative",
    "last_n_days": 30
}
Previous
Specifying the primary metric
Next
Supported dimensions
Built with