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

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

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

## Request

- Base URL: `https://api.citeladder.com`
- URL: `https://api.citeladder.com/v1/projects/{project_id}/ai-traffic/pages`
- 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
- `bot_id` string, nullable
- `pattern` string, nullable
- `folder` string, nullable
- `resource_class` string, nullable
- `verification` string, nullable
- `sort` string, nullable
- `cursor` string, nullable
- `limit` integer, nullable

## Response `200`

Successful Response

- AiTrafficPages
  - `window_start` string, required
  - `window_end` string, required
  - `items` object[], required
    - `url_hash` string, required
    - `canonical_url` string, required
    - `display_path` string, required
    - `folder` string, required
    - `resource_class` string, required
    - `crawl` TrafficLeg, required
      - `state` 'not_connected' | 'unknown' | 'unavailable' | 'zero' | 'value' | 'non_comparable' | 'flagged', required
      - `value` number, nullable, required
      - `coverage` string, nullable, required
      - `reason` string, nullable, required
    - `referrals` TrafficLeg, required
      - `state` 'not_connected' | 'unknown' | 'unavailable' | 'zero' | 'value' | 'non_comparable' | 'flagged', required
      - `value` number, nullable, required
      - `coverage` string, nullable, required
      - `reason` string, nullable, required
    - `citations` TrafficLeg, required
      - `state` 'not_connected' | 'unknown' | 'unavailable' | 'zero' | 'value' | 'non_comparable' | 'flagged', required
      - `value` number, nullable, required
      - `coverage` string, nullable, required
      - `reason` string, nullable, required
    - `findings` TrafficLeg, required
      - `state` 'not_connected' | 'unknown' | 'unavailable' | 'zero' | 'value' | 'non_comparable' | 'flagged', required
      - `value` number, nullable, required
      - `coverage` string, nullable, required
      - `reason` string, nullable, required
    - `key_events` number, nullable, required
    - `last_crawl` string, nullable, required
    - `errors_4xx` number, nullable, required
    - `errors_5xx` number, nullable, required
  - `next_cursor` string, nullable, required
  - `observed_crawl_coverage` object, required
    - `state` string, required
    - `share` number, nullable, required
    - `known_pages` number, required
    - `observed_pages` number, nullable, required
    - `inventory_date` string, nullable, required
    - `inventory_complete` boolean, required
    - `sample_mode` boolean, required
    - `label` 'Observed crawl coverage', 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)