agent-traffic

Get 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's registered domain, lowercase, without scheme or www.
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.

get/{brand_id}/sites/{site_id}/agent-traffic

Request

Base URL
https://api.scrunchai.com/v1
Auth
HTTP bearer

Path parameters

brand_idinteger required

string required

string binary required

Query parameters

start_datestring date required

Start date for the query range (inclusive). Format: YYYY-MM-DD.

end_datestring date required

End date for the query range (inclusive). Format: YYYY-MM-DD.

fieldsstring nullable

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_bucket'day' | 'week'

Time aggregation bucket for grouping results. Options: day, week. Defaults to day.

pathstring nullable

Filter results to a specific URL path or path prefix.

limitinteger

Maximum number of rows to return. Use with offset for pagination.

offsetinteger

Number of rows to skip before returning results. Use with limit for pagination.

Response

Successful Response

Changes

No recorded changes to this operation across all 31 revisions of this API.