Date range

Date ranges allow you to filter search results by time periods.

API

In the API, you can specify the temporal filter with the request object timestamp.

  curl -X POST 'https://api.bigdata.com/v1/search' \
  -H 'Content-Type: application/json' \
  -H 'X-API-KEY: <your-api-key>' \
  --data '{
  "query": {
    "filters": {
      "timestamp": {
        "start": "2025-09-15T22:00:00.000Z",
        "end": "2025-10-15T21:59:59.999Z"
      },
      "keyword": {
        "any_of": [
          "tesla"
        ]
      },
      "entity": {
        "any_of": [
          "228D42"
        ]
      }
    },
    "max_chunks": 2
  }
}'

Python SDK

Two types of date ranges can be used in the search:

• Rolling date ranges (RollingDateRange): Predefined relative date ranges include:

  • RollingDateRange.LAST_ONE_HOURS
  • RollingDateRange.LAST_THREE_HOURS
  • RollingDateRange.LAST_SIX_HOURS
  • RollingDateRange.LAST_NINE_HOURS
  • RollingDateRange.LAST_TWELVE_HOURS
  • RollingDateRange.LAST_TWENTY_FOUR_HOURS
  • RollingDateRange.LAST_FORTY_EIGHT_HOURS
  • RollingDateRange.LAST_SEVEN_DAYS
  • RollingDateRange.LAST_THIRTY_DAYS
  • RollingDateRange.LAST_NINETY_DAYS
  • RollingDateRange.YEAR_TO_DATE
  • RollingDateRange.LAST_YEAR

  Sunsetting:

  • RollingDateRange.TODAY
  • RollingDateRange.YESTERDAY
  • RollingDateRange.THIS_WEEK
  • RollingDateRange.LAST_WEEK
  from bigdata_client import Bigdata
  from bigdata_client.daterange import RollingDateRange
  from bigdata_client.query import Entity, Keyword
  
  MICROSOFT = "228D42"
  
  query = Entity(MICROSOFT) | Keyword("tesla")
  
  bigdata = Bigdata()
  search = bigdata.search.new(
      query=query,
      date_range=RollingDateRange.LAST_THIRTY_DAYS
  )
  
  documents = search.run(2)
  print(documents)
  

• AbsoluteDateRange: Absolute date range defined by start and end dates. Dates must follow ISO 8601

Examples:

from bigdata_client import Bigdata
from bigdata_client.daterange import AbsoluteDateRange
from bigdata_client.query import Entity, Keyword
from datetime import datetime
import pytz

MICROSOFT = "228D42"

query = Entity(MICROSOFT) | Keyword("tesla")
# The following are equivalent
date_range = AbsoluteDateRange(datetime(2024, 1, 1), datetime(2024, 1, 31))
date_range = AbsoluteDateRange("2024-01-01", "2024-01-31")
date_range = AbsoluteDateRange("2024-01-01T00:00:00", "2024-01-31T00:00:00")
# Or you can set a timezone
end_date =  pytz.timezone("Asia/Tokyo").localize(datetime(2024, 1, 31, 9))
date_range = AbsoluteDateRange("2024-01-01T01:00:00+01:00", end_date)

bigdata = Bigdata()
search = bigdata.search.new(
    query=query,
    date_range=daterange
)

documents = search.run(2)
print(documents)