---
title: "AI referral traffic (Scale+)"
method: GET
path: "/metrics/ai_traffic"
tags: ["AI & Agent Traffic"]
---

# AI referral traffic (Scale+)

`GET /metrics/ai_traffic`

AI referral traffic from AI assistants (ChatGPT, Perplexity, Gemini, etc.), measured from the connected web analytics provider (GA4, Adobe, PostHog, Plausible, Piano). Requires a connected provider and the Scale plan; otherwise ERR_AI_TRAFFIC_NOT_CONNECTED / ERR_PLAN_REQUIRED.

## Query parameters

- `project_id` integer, required
- `range` integer
- `from` string, date-time
- `to` string, date-time
- `source` string
- `granularity` 'day' | 'week' | 'month'

## Response `200`

AI referral traffic data

## Other responses

- `403` — Plan upgrade required
- `404` — Resource not found

## Changes

- **2026-08-05** `17bc6c8b615a` — 2 info
  - api tag `AI & Agent Traffic` added
  - api tag `Metrics` removed

[Change history](https://skmtc.dev/llmpulse/apis/llm-pulse-api/changes/metrics/ai_traffic/get.md)

---

[API](https://skmtc.dev/llmpulse/apis/llm-pulse-api.md) · [All operations](https://skmtc.dev/llmpulse/apis/llm-pulse-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/llmpulse/llm-pulse-api/revisions/b1f6040a24b9/schema)