Get Bots Report V1
Get bot traffic report from the daily aggregated materialized view.
This endpoint queries pre-aggregated daily bot data, making it efficient for large date ranges and high-traffic sites.
Metrics:
- count: unique bot visits
- citations: unique citation events
- indexing: unique indexing events
- training: unique training events
- last_visit: most recent visit timestamp
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, year, relative_week Dimensions to group the report by.
date, path, bot_name, bot_provider 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.
Pagination settings for the report results.
End date for logs. Accepts same formats as start_date. Defaults to now if omitted.
Numeric filters applied after report metrics are calculated.
Filters for bots report.
Filter by request path
- PathFilter
- BotNameFilter
- BotProviderFilter