Get Bots Report V2
Get bot traffic report from the hourly aggregated materialized view (UTC-based).
Supports date_interval=“hour”, calendar intervals through “year”, “quarter”, and “relative_week”.
Metrics:
- count: unique bot visits
- citations: unique citation events (ai_assistant bot type)
- indexing: unique indexing events (index bot type)
- training: unique training events (ai_training bot type)
- last_visit: most recent visit timestamp
Dimensions:
- date, path, bot_name, bot_provider, bot_type
Authorizations
Body
count, citations, indexing, training, last_visit Domain to query logs for.
Start date for logs. Accepts: YYYY-MM-DD, YYYY-MM-DD HH:MM, YYYY-MM-DD HH:MM:SS, or full ISO timestamp.
Date interval for the report. (only used with date dimension)
hour, day, week, month, quarter, year, relative_week Dimensions to group the report by.
date, hour, path, bot_name, bot_provider, bot_type Custom ordering of the report results.
The order is a record of key-value pairs where:
- key is the field to order by, which can be a metric or dimension
- value is the direction of the order, either 'asc' for ascending or 'desc' for descending.
When not specified, the default order is the first metric in the query descending.
{ "date": "asc" }Pagination settings for the report results.
End date in UTC. Accepts same formats as start_date. Defaults to now UTC if omitted.
Numeric filters applied after report metrics are calculated.
Filters for bots report.
Filter by request path
- PathFilter
- BotNameFilter
- BotProviderFilter
- BotTypeFilter