---
title: "Get AI fetch correlation report"
method: GET
path: "/api/sites/{id}/ai-fetch/correlation"
tags: ["Sites"]
---

# Get AI fetch correlation report

`GET /api/sites/{id}/ai-fetch/correlation`

## Request

- Base URL: `https://demo.hitkeep.com`
- URL: `https://demo.hitkeep.com/api/sites/{id}/ai-fetch/correlation`
- Auth: one of:
  - API key in cookie `hk_token`
  - HTTP bearer
  - API key in header `X-API-Key`

Returns directional AI fetch correlation metrics for a site by matching AI crawler fetches to later AI-referred visits on the same path within a bounded window. Assistant filters apply to the fetch side only; correlated visit counts include any AI assistant referrer that later drove a human visit to the same path.

## Path parameters

- `id` string, uuid, required

## Query parameters

- `from` string, date-time
- `to` string, date-time
- `assistant_name` string
- `assistant_family` string
- `resource_type` 'html' | 'document' | 'image' | 'other'
- `path` string
- `window_days` integer

## Response `200`

AI fetch correlation report

- AIFetchCorrelationReport
  - `citation_paths` AIFetchCorrelationPathRow[]
    - `ai_referred_visits` integer
    - `fetch_count` integer
    - `path` string
  - `citation_yield` AIFetchCitationYieldRow[]
    - `ai_referred_visits` integer
    - `assistant_name` string
    - `citation_yield_pct` number
    - `fetch_count` integer
    - `path` string
  - `failure_hotspots` AIFetchFailureHotspot[]
    - `assistant_name` string
    - `error_rate_pct` number
    - `error_requests` integer
    - `path_prefix` string
    - `total_requests` integer
  - `opportunity_pages` AIFetchOpportunityRow[]
    - `ai_referred_visits` integer
    - `error_rate_pct` number
    - `error_requests` integer
    - `fetch_count` integer
    - `path` string
  - `summary` AIFetchCorrelationSummary
    - `ai_referred_visits` integer
    - `correlated_paths` integer
    - `fetched_paths` integer
    - `total_fetches` integer
    - `uncorrelated_fetches` 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)