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

Specify a date range limited to the month of March in 2024:

"date_range": {
    "type": "absolute",
    "start": "2024-03-01",
    "end": "2024-03-31"
}

To use a relative date range, pass a RelativeDateRange object in the date_range parameter.

RelativeDateRange

Specify a date range covering the last 30 days:

"date_range": {
    "type": "relative",
    "last_n_days": 30
}