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 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.
Documentation Index
Fetch the complete documentation index at: https://developers.scrunch.com/llms.txt
Use this file to discover all available pages before exploring further.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
The unique identifier of the site to retrieve agent traffic for.
26[0-7][0123456789ABCDEFGHJKMNPQRSTVWXYZ]{25}Query Parameters
Start 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.
Time aggregation bucket for grouping results. Options: day, week, month. Defaults to day.
day, week Filter results to a specific URL path or path prefix.
Maximum number of rows to return. Use with offset for pagination.
1 <= x <= 100000Number of rows to skip before returning results. Use with limit for pagination.
x >= 0