---
title: "Get Agent Traffic"
method: GET
path: "/{brand_id}/sites/{site_id}/agent-traffic"
tags: ["agent-traffic"]
---

# Get Agent Traffic

`GET /{brand_id}/sites/{site_id}/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

- `brand_id` integer, required
- `site_id` union, required — The unique identifier of the site to retrieve agent traffic for.
  - string
  - string, binary

## Query parameters

- `start_date` string, date, required — Start date for the query range (inclusive). Format: YYYY-MM-DD.
- `end_date` string, date, required — End date for the query range (inclusive). Format: YYYY-MM-DD.
- `fields` string, 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`.
- `path` string, nullable — Filter results to a specific URL path or path prefix.
- `limit` integer — Maximum number of rows to return. Use with offset for pagination.
- `offset` integer — Number of rows to skip before returning results. Use with limit for pagination.

## Response `200`

Successful Response

- AgentTrafficResponse — Response containing agent traffic data with metadata and aggregated traffic records.
  - `meta` AgentTrafficMeta, required — Metadata about the agent traffic query results.
    - `start_date` string, date, required — Start date of the query range.
    - `end_date` string, date, required — End date of the query range.
    - `time_bucket` 'day' | 'week', required — Time aggregation bucket used for grouping results.
  - `data` AgentTrafficRow[], required — Array of agent traffic records matching the query criteria.
    - `requests` integer, required — Number of requests/hits for this combination of dimensions.
    - `date` string, nullable — Date of the traffic record in YYYY-MM-DD format.
    - `site` string, nullable — The site domain being analyzed.
    - `path` string, nullable — URL path on the site.
    - `agent_source` string, nullable — The source/origin of the agent (e.g., OpenAI, Google, Anthropic, Microsoft).
    - `agent_type` string, nullable — Classification of the agent type (e.g., GPTBot, ClaudeBot, Google-Extended, Googlebot).

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/scrunchai/apis/scrunch-data-api.md) · [All operations](https://skmtc.net/scrunchai/apis/scrunch-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/scrunchai/scrunch-data-api/revisions/c4fe20c603a3/schema)