Docs menu

Get bot traffic summary

AI answer, indexing, training and other crawler requests, IP verification, providers and crawlers for a range. Pro and Team plans.

GET https://usedatasense.com/api/v1/bot-traffic/summary

Permission: analytics:read. MCP tool: datasense_bot_traffic_summary.

Request

Parameter	In	Type	Required	Description
`websiteId`	query	string	With an account token	The website to query. Required with an account token or OAuth connection that can reach several websites; omit with a ds_sk_ website key.
`startAt`	query	string	No	First day of the range, YYYY-MM-DD. Must be sent with endAt. Omit both for all time.
`endAt`	query	string	No	Last day of the range (inclusive), YYYY-MM-DD. Must be sent with startAt.
`timezone`	query	string	No	IANA timezone for the days and buckets, such as America/New_York. Defaults to the website's timezone.
`category`	query	string	No	answer: assistants fetching a page for a user; index: search indexing; training: model training; other. One of `answer`, `index`, `training`, `other`.
`provider`	query	string	No	Only this company, such as OpenAI or Anthropic.
`agent`	query	string	No	Only this crawler, such as GPTBot.
`verify`	query	string	No	trusted hides spoofed requests, verified keeps IP-verified ones only, all keeps everything. One of `trusted`, `verified`, `all`. Default `trusted`.

curl "https://usedatasense.com/api/v1/bot-traffic/summary?startAt=2026-10-01&endAt=2026-10-26" \
  -H "Authorization: Bearer ds_sk_xxx"

With an account token, add websiteId:

curl "https://usedatasense.com/api/v1/bot-traffic/summary?websiteId=YOUR_SITE_ID" \
  -H "Authorization: Bearer ds_at_xxx"

json

{
  "status": "success",
  "data": { … }
}

AI answer, indexing, training and other crawler requests, IP verification, providers and crawlers for a range. Pro and Team plans.

GET https://usedatasense.com/api/v1/bot-traffic/summary

Permission: analytics:read. MCP tool: datasense_bot_traffic_summary.

Parameter	In	Type	Required	Description
`websiteId`	query	string	With an account token	The website to query. Required with an account token or OAuth connection that can reach several websites; omit with a ds_sk_ website key.
`startAt`	query	string	No	First day of the range, YYYY-MM-DD. Must be sent with endAt. Omit both for all time.
`endAt`	query	string	No	Last day of the range (inclusive), YYYY-MM-DD. Must be sent with startAt.
`timezone`	query	string	No	IANA timezone for the days and buckets, such as America/New_York. Defaults to the website's timezone.
`category`	query	string	No	answer: assistants fetching a page for a user; index: search indexing; training: model training; other. One of `answer`, `index`, `training`, `other`.
`provider`	query	string	No	Only this company, such as OpenAI or Anthropic.
`agent`	query	string	No	Only this crawler, such as GPTBot.
`verify`	query	string	No	trusted hides spoofed requests, verified keeps IP-verified ones only, all keeps everything. One of `trusted`, `verified`, `all`. Default `trusted`.

curl "https://usedatasense.com/api/v1/bot-traffic/summary?startAt=2026-10-01&endAt=2026-10-26" \
  -H "Authorization: Bearer ds_sk_xxx"

With an account token, add websiteId:

curl "https://usedatasense.com/api/v1/bot-traffic/summary?websiteId=YOUR_SITE_ID" \
  -H "Authorization: Bearer ds_at_xxx"

json

{
  "status": "success",
  "data": { … }
}