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

JavaScript

JavaScript

import Profound from '@profoundai/client';

const client = new Profound({
  apiKey: process.env['PROFOUND_API_KEY'], // This is the default and can be omitted
});

const reportResponse = await client.reports.getBotsReportV2({
  domain: 'domain',
  metrics: ['count'],
  start_date: '2019-12-27T18:11:19.117Z',
});

console.log(reportResponse.data);

200

{
  "info": {
    "total_rows": 123,
    "query": {}
  },
  "data": [
    {
      "metrics": [
        123
      ],
      "dimensions": [
        "<string>"
      ]
    }
  ]
}

Authorizations

APIKeyHeaderBearerAuth

X-API-Key · string · header · required

Body

application/json

metrics · (enum<string> | string)[] · required

Available options: count, citations, indexing, training, last_visit

domain · string · required

Domain to query logs for.

start_date · string<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.

date_interval · enum<string> · default: day

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

Available options: hour, day, week, month, quarter, year, relative_week

dimensions · enum<string>[]

Dimensions to group the report by.

Available options: date, hour, path, bot_name, bot_provider, bot_type

order_by · Order By · object

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.

Show child attributes

Example:

{ "date": "asc" }

pagination · Pagination · object

Pagination settings for the report results.

Show child attributes

end_date · string<date-time>

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

organization_id · string<uuid> | null

timezone · string · default: UTC

IANA timezone name for date bucketing and filter boundaries.

metric_filters · NumericMetricFilter · object[]

Numeric filters applied after report metrics are calculated.

Show child attributes

filters · (PathFilter · object | BotNameFilter · object | BotProviderFilter · object | BotTypeFilter · object)[]

Filters for bots report.

Filter by request path

PathFilter

BotNameFilter

BotProviderFilter

BotTypeFilter

Show child attributes

domain_id · string<uuid> | null

Domain UUID used for tag lookups.

tags · string[]

Response

200

application/json

Successful Response

Base response model for reports.

info · Info · object · required

Base model for report information.

Show child attributes

data · Result · object[] · required

Show child attributes