Get bot time series
GET
Requests per time bucket of the top limit keys of one dimension (dim, the bot category by default), optionally of one category only.
Requires analytics:read on the site (an API key, or a signed-in member's role). Share links: 401.
header
x-api-key<token>An organization API key (ak_…), with the permissions and the sites it was created with. For servers and scripts: no cookie and no Origin check. Also accepted as Authorization: Bearer ak_… (apiKeyBearer). A request carries one credential: a key sent with a share token or a live session cookie is 400 (details.reason: ambiguous_credentials).
Scope: analytics:read
siteId*stringstart?stringend?stringlast?stringall?"true"Value in
"true"tz?stringbucket?stringValue in
"minute""5m""15m""hour""day""week""month""year"dim?stringDefault
"bot_category"Value in
"bot_name""bot_operator""bot_category""asn_org""pathname""country""layer"category?stringOnly bot requests of this category
Value in
"search""ai_crawler""ai_assistant""seo""monitoring""social_preview""scraper""automation""unknown"limit?integerThe top keys by requests in the window
Range
1 <= value <= 20Default
5OK
application/json- response
data*array<>meta*curl -X GET 'https://pilotfox.app/api/v1/sites/string/bots/timeseries'Example Response200
{ "data": [ { "key": "string", "total": 0, "series": [ { "t": "string", "count": 0 } ] } ], "meta": { "window": { "from": "string", "to": "string", "tz": "string", "bucket": "minute" }, "compare": { "from": "string", "to": "string" }, "totalCount": -9007199254740991, "nextCursor": "string", "truncated": true, "cache": "hit" }}