Recall
GNQL V3 Recall Stats
Get the number of unique IPs that match a GNQL query per hour/day over a given time range.
get/v3/gnql/timeseries/stats
Query parameters
querystring required
GNQL query string
startstring date-time
Start date for the desired time range
endstring date-time
End date for the desired time range
format'csv' | 'json'
Specifies the desired format of the results. Must be either csv or json.
interval'hour' | 'day' required
Specifies the time interval over which to aggregate unique IPs that return the given GNQL query.
Response
Query successful.
Example response
{
"count": 1500,
"min": 10,
"max": 250,
"data": [
{
"date": "2025-11-10 14:00:00.000",
"count": 125
},
{
"date": "2025-11-10 15:00:00.000",
"count": 250
},
{
"date": "2025-11-10 16:00:00.000",
"count": 180
}
]
}