---
title: "Shared AI activity report"
method: GET
path: "/api/share/{token}/sites/{id}/ai-activity"
tags: ["Share"]
---

# Shared AI activity report

`GET /api/share/{token}/sites/{id}/ai-activity`

## Request

- Base URL: `https://demo.hitkeep.com`
- URL: `https://demo.hitkeep.com/api/share/{token}/sites/{id}/ai-activity`
- Auth: none declared

Returns the unified AI activity report through a read-only share token, including the server-log fetch side: the query runs under the token grant for the shared site. Repeatable goal_id and funnel_id parameters select session cohorts for tracked hits, pageviews, series, and comparison windows; fetch records are never cohort-filtered.

## Path parameters

- `token` string, required
- `id` string, uuid, required

## Query parameters

- `from` string, date-time
- `to` string, date-time
- `filter` string
- `filter_type` string
- `filter_value` string
- `goal_id` string[]
- `funnel_id` string[]
- `compare_from` string, date-time
- `compare_to` string, date-time

## Response `200`

AI activity report

- AIActivityReport: Unified AI activity report merging tracked AI hits with server-log AI fetch records. Every count follows one rule: tracked hits plus fetch records, and each row exposes its tracked_hits/fetch_count provenance. Path, ai_bot, and ai_bot_category filters apply to both sides; ai_source excludes fetch records; hit-only dimensions leave fetch totals visible. Depth metrics describe the fetch side only, because tracked hits carry no status code, response time, or transferred bytes. Goal and funnel cohorts apply to tracked hits and pageview denominators, never fetch records.
  - `ai_requests` integer
  - `comparison` object: Merged counters for the compare_from/compare_to window. Absent unless a comparison range is requested.
    - `ai_requests` integer
    - `fetch_count` integer
    - `pageviews` integer
    - `paths_crawled` integer
    - `referral_visits` integer
    - `tracked_hits` integer
    - `unique_agents` integer
  - `error_rate_4xx` number
  - `error_rate_5xx` number
  - `fetch_count` integer
  - `median_response_ms` integer
  - `pageviews` integer: Total hits for the range under the non-AI filters only, so the AI share of a segment stays comparable while an AI dimension is drilled into.
  - `paths_crawled` integer: Distinct paths seen on either side, counted before the top-list cap.
  - `referral_visits` integer: Distinct sessions referred by a known AI surface across the whole range.
  - `series` AIActivitySeriesPoint[]
    - `ai_requests` integer: Tracked AI bot hits plus AI fetch records in the bucket.
    - `fetch_count` integer
    - `referral_visits` integer: Distinct sessions referred by a known AI surface inside the bucket. Buckets are not additive: a session spanning two buckets counts in both.
    - `time` string, date-time
    - `tracked_hits` integer
  - `top_agents` AIActivityStat[]
    - `fetch_count` integer
    - `name` string
    - `tracked_hits` integer
    - `value` integer
  - `top_agents_by_category` object: Merged agent top list per AI agent category, keyed by category.
  - `top_categories` AIActivityStat[]
    - `fetch_count` integer
    - `name` string
    - `tracked_hits` integer
    - `value` integer
  - `top_error_paths` AIActivityStat[]
    - `fetch_count` integer
    - `name` string
    - `tracked_hits` integer
    - `value` integer
  - `top_families` AIActivityStat[]
    - `fetch_count` integer
    - `name` string
    - `tracked_hits` integer
    - `value` integer
  - `top_paths` AIActivityStat[]
    - `fetch_count` integer
    - `name` string
    - `tracked_hits` integer
    - `value` integer
  - `top_resource_types` AIActivityStat[]
    - `fetch_count` integer
    - `name` string
    - `tracked_hits` integer
    - `value` integer
  - `top_sources` AIActivityStat[]
    - `fetch_count` integer
    - `name` string
    - `tracked_hits` integer
    - `value` integer
  - `total_bytes` integer
  - `tracked_hits` integer
  - `unique_agents` integer

---

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