API reference / Analytics
List the pages that AI crawlers read
The pages that AI crawlers asked for in a period, most requests first. Each page has the status codes that the site answered, and the crawlers that asked. (A 404 is a page that a crawler looked for and did not find.) search matches the start of the path, and * matches any characters.
/api/v1/analytics/bots/pagesOther ways to call it
troopy analytics bots pagestroopy_list_analytics_bot_pagesQuery 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
searchstringAt most 200 characters
pageinteger1-based page number
Default 1 · At least 1
limitintegerPages per page, at most 500
Default 50 · At least 1 · At most 500
Response
200 · application/jsondata*array<object>6 properties
host*stringpath*stringrequests*integerverified*integerstatuses*array<object>2 properties
status*integer | nullrequests*integercrawlers*array<string>pagination*object4 properties
page*integerlimit*integertotal*integerpages*integer