Sign in

v84

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-0985248447.1 KB
Reports
Bot Traffic Reports

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
post/v2/reports/bots

Request body

date_interval'hour' | 'day' | 'week' | 'month' | 'quarter' | 'year' | 'relative_week'

Date interval for the report. (only used with date dimension)

dimensionsstring[]

Dimensions to group the report by.

metricsstring[] required
order_byobject

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.

domainstring required

Domain to query logs for.

start_datestring date-time required

Start date for logs. Accepts: YYYY-MM-DD, YYYY-MM-DD HH:MM, YYYY-MM-DD HH:MM:SS, or full ISO timestamp.

end_datestring date-time

End date in UTC. Accepts same formats as start_date. Defaults to now UTC if omitted.

organization_idstring uuid nullable

Example request

{
  "order_by": {
    "date": "asc"
  }
}

Response

Successful Response