Get AI fetch correlation report
GET /api/sites/{id}/ai-fetch/correlation
GET
/api/sites/{id}/ai-fetch/correlation
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.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ” id
required
string format: uuid
Query Parameters
Section titled “Query Parameters ” from
string format: date-time
to
string format: date-time
assistant_name
string
Optional AI assistant bot name filter.
assistant_family
string
Optional AI assistant family filter.
resource_type
string
Optional AI fetch resource type filter.
window_days
integer
Directional correlation window in days. Must be between 1 and 90. Defaults to 30.
Responses
Section titled “ Responses ”AI fetch correlation report
object
citation_yield
Array<object>
object
ai_referred_visits
integer
assistant_name
string
citation_yield_pct
number
fetch_count
integer
path
string
failure_hotspots
Array<object>
object
assistant_name
string
error_rate_pct
number
error_requests
integer
path_prefix
string
total_requests
integer
opportunity_pages
Array<object>
object
ai_referred_visits
integer
error_rate_pct
number
error_requests
integer
fetch_count
integer
path
string
summary
object
ai_referred_visits
integer
correlated_paths
integer
fetched_paths
integer
total_fetches
integer
uncorrelated_fetches
integer