The starting timestamp for this time interval in format 'YYYY-MM-DD HH:mm:ss.SSS'. For hourly intervals, the time component represents the hour. For daily intervals, the time will be 00:00:00.000.
count
integer
The number of unique IPs matching the query in this time interval
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://api-evangelist.github.io/greynoise/json-schema/greynoise-time-series-stats-record-schema.json",
"title": "TimeSeriesStatsRecord",
"type": "object",
"description": "A single aggregated data point in a timeseries stats response",
"properties": {
"date": {
"type": "string",
"description": "The starting timestamp for this time interval in format\n'YYYY-MM-DD HH:mm:ss.SSS'.\nFor hourly intervals, the time component represents the hour.\nFor daily intervals, the time will be 00:00:00.000.\n",
"example": "2025-11-10 14:00:00.000"
},
"count": {
"type": "integer",
"description": "The number of unique IPs matching the query in this time\ninterval\n",
"example": 125
}
}
}
Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.