- API
- Python SDK
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
}
}'
Two types of date ranges can be used in the search:
-
Rolling date ranges (
RollingDateRange): Predefined relative date ranges include:RollingDateRange.LAST_ONE_HOURSRollingDateRange.LAST_THREE_HOURSRollingDateRange.LAST_SIX_HOURSRollingDateRange.LAST_NINE_HOURSRollingDateRange.LAST_TWELVE_HOURSRollingDateRange.LAST_TWENTY_FOUR_HOURSRollingDateRange.LAST_FORTY_EIGHT_HOURSRollingDateRange.LAST_SEVEN_DAYSRollingDateRange.LAST_THIRTY_DAYSRollingDateRange.LAST_NINETY_DAYSRollingDateRange.YEAR_TO_DATERollingDateRange.LAST_YEAR
RollingDateRange.TODAYRollingDateRange.YESTERDAYRollingDateRange.THIS_WEEKRollingDateRange.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
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)