v1
latestOpenAPI 3.1.02026-07-263370112.1 KBGet Agent Traffic
Retrieve aggregated bot and AI agent traffic data for a specific site.
This endpoint provides visibility into how AI agents and bots are accessing your web properties. Use it to analyze traffic patterns, identify top agents, and understand crawl behavior over time.
Available Dimensions
The following dimensions can be included in the fields parameter to group results:
| Field | Description |
|---|---|
| date | Daily timestamp for the traffic record |
| site | The site domain being analyzed |
| path | URL path on the site |
| agent_source | The source/origin of the agent (e.g., OpenAI, Google, Anthropic) |
| agent_type | Classification of the agent type |
Metrics
Traffic counts are automatically included in the response based on the selected dimensions.
Path parameters
The unique identifier of the site to retrieve agent traffic for.
Query parameters
Start date for the query range (inclusive). Format: YYYY-MM-DD.
Start date for the query range (inclusive). Format: YYYY-MM-DD.
End date for the query range (inclusive). Format: YYYY-MM-DD.
End date for the query range (inclusive). Format: YYYY-MM-DD.
Comma-separated list of dimensions to include in the response. Available dimensions: date, site, path, agent_source, agent_type. If not specified, returns aggregated totals.
Comma-separated list of dimensions to include in the response. Available dimensions: date, site, path, agent_source, agent_type. If not specified, returns aggregated totals.
Time aggregation bucket for grouping results. Options: day, week, month. Defaults to day.
Time aggregation bucket for grouping results. Options: day, week, month. Defaults to day.
Filter results to a specific URL path or path prefix.
Filter results to a specific URL path or path prefix.
Maximum number of rows to return. Use with offset for pagination.
Maximum number of rows to return. Use with offset for pagination.
Number of rows to skip before returning results. Use with limit for pagination.
Number of rows to skip before returning results. Use with limit for pagination.
Response
Successful Response