---
title: "GET /v1/projects/{project_id}/ai-traffic/overview"
method: GET
path: "/v1/projects/{project_id}/ai-traffic/overview"
tags: ["ai-traffic"]
---

# GET /v1/projects/{project_id}/ai-traffic/overview

`GET /v1/projects/{project_id}/ai-traffic/overview`

## Request

- Base URL: `https://api.citeladder.com`
- URL: `https://api.citeladder.com/v1/projects/{project_id}/ai-traffic/overview`
- Auth: HTTP bearer

## Path parameters

- `project_id` string, uuid, required

## Query parameters

- `range` string, nullable
- `start_date` string, date, nullable
- `end_date` string, date, nullable
- `purpose` string, nullable
- `verification` string, nullable
- `bot_id` string, nullable
- `status` integer, nullable
- `folder` string, nullable
- `resource_class` string, nullable
- `cursor` string, nullable
- `limit` integer, nullable

## Response `200`

Successful Response

- AiTrafficOverview
  - `crawl` CrawlSummary, required
    - `unit` 'requests', required
    - `identity_level` 'path', required
    - `connection` 'not_connected' | 'awaiting_data' | 'connected', required
    - `coverage` 'complete' | 'declared_complete' | 'partial' | 'unknown', required
    - `reporting_timezone` string, required
    - `last_processed_at` string, nullable, required
    - `requests` number, nullable, required
    - `pages` number, nullable, required
    - `active_bots` number, nullable, required
    - `error_share` number, nullable, required
    - `failed_verification_requests` number, nullable, required
    - `series` object[], required
      - `date` string, required
      - `purpose` union, required
        - 'ai_training' | 'ai_search' | 'ai_user_fetch' | 'search_engine' | 'other'
        - 'unknown'
      - `requests` number, required
  - `referrals` AiReferrals, required
    - `project_id` string, uuid, required
    - `window_start` string, required
    - `window_end` string, required
    - `granularity` 'day' | 'week' | 'month', required
    - `referral_volume` object[], required
      - `date` string, required
      - `value` number, nullable, required
    - `referral_share` object[], required
      - `date` string, required
      - `value` number, nullable, required
    - `sources` AiReferralSourceRow[], required
      - `ai_source` 'chatgpt' | 'gemini' | 'claude' | 'perplexity' | 'copilot' | 'google_ai_overview', required
      - `sessions` integer, required
      - `share` number, nullable, required
    - `analyzer_version` string, required
    - `formula_version` string, required
    - `scope` 'property-wide', required
    - `reporting_timezone` string, nullable, required
    - `currency_code` string, nullable, required
    - `analytics_quality` object, required
    - `unattributed_landing` number, nullable, required
    - `source_measures` object[], required
      - `ai_source` 'chatgpt' | 'gemini' | 'claude' | 'perplexity' | 'copilot' | 'google_ai_overview' | 'other', required
      - `sessions` number, nullable, required
      - `key_events` number, nullable, required
      - `engagement_rate` number, nullable, required
      - `transactions` number, nullable, required
      - `purchase_revenue` number, nullable, required
    - `channel_comparison` object[], required
      - `channel` string, required
      - `sessions` number, nullable, required
      - `key_events` number, nullable, required
      - `engagement_rate` number, nullable, required
    - `landing_pages` object[], required
      - `url_hash` string, required
      - `canonical_url` string, required
      - `ai_source` 'chatgpt' | 'gemini' | 'claude' | 'perplexity' | 'copilot' | 'google_ai_overview' | 'other', required
      - `sessions` number, nullable, required
      - `key_events` number, nullable, required
      - `analytics_quality` string[], required
  - `citations` object, required
    - `unit` 'tracked_citations', required
    - `count` number, nullable, required
    - `label` string, required

---

[API](https://skmtc.dev/citeladder/apis/citeladder-api.md) · [All operations](https://skmtc.dev/citeladder/apis/citeladder-api/llms.txt) · [OpenAPI document](https://skmtc.dev/citeladder/apis/citeladder-api/revisions/8c9f6aea40c2?raw)