API reference / Analytics
Get the AI crawler traffic
The AI crawlers that read the site in a period, as the site's server reported them with the troopy-analytics crawlers package. It gives totals, and the requests by category, by company and by crawler. The categories are answer, search, training and other. An answer crawler reads a page to answer a person in ChatGPT, Claude or Perplexity. It also gives the requests for robots.txt, llms.txt, sitemaps and .md files. verified counts the requests from the published IP ranges of the company.
/api/v1/analytics/botsOther ways to call it
troopy analytics botstroopy_get_analytics_bot_trafficQuery parameters
periodenum<string>now is the last 10 minutes. 7d and 30d end today. 3m, 6m and 12m are whole months that end with this month. week starts on Monday. custom needs from and to
nowtodayyesterday24h7d30d3m6m12mweekmonthyearallcustom
Default "30d"
fromstringYYYY-MM-DD, in the workspace's time zone
date
tostringYYYY-MM-DD. The period includes this day
date
categoryenum<string>answer (a read to answer a person), search (indexing), training or other
answersearchtrainingother
verificationenum<string>verified: from the company's published IP ranges
allverifiedunverified
Default "all"
companystringAt most 40 characters
Response
200 · application/jsondata*object8 properties
total*integerverified*integerRequests from the company's published IP ranges
byCategory*object4 properties
answer*integersearch*integertraining*integerother*integercompanies*array<object>4 properties
company*stringrequests*integerverified*integeranswers*integercrawlers*array<object>6 properties
id*stringcompany*stringagent*stringcategory*enum<string>answersearchtrainingother
requests*integerverified*integerfiles*array<object>robots.txt, llms.txt, sitemaps and .md files
2 properties
kind*stringrequests*integerbuckets*array<string>The period's buckets, by its interval
series*array<object>Each company's requests over time, by category
3 properties
company*stringcategory*enum<string>answersearchtrainingother
counts*array<integer>Requests in each bucket