---
title: "Get website AI visibility analytics"
method: GET
path: "/v1/workspace/website/{website_id}/analytics/ai-visibility"
tags: ["Analytics"]
---

# Get website AI visibility analytics

`GET /v1/workspace/website/{website_id}/analytics/ai-visibility`

## Request

- Base URL: `https://api.lindo.ai`
- URL: `https://api.lindo.ai/v1/workspace/website/{website_id}/analytics/ai-visibility`
- Auth: HTTP bearer

Retrieves AI-specific traffic analytics for a website: AI bot crawls, AI platform referrals, top cited pages, and a time series of both signals. Supports optional date range filtering.

## Path parameters

- `website_id` string, required: Unique identifier of the website

## Query parameters

- `from` string: Start date for analytics data (ISO timestamp)
- `to` string: End date for analytics data (ISO timestamp)

## Response `200`

AI visibility analytics retrieved successfully

- WebsiteAiVisibilityResponse
  - `success` true, required: Indicates the operation was successful
  - `result` WebsiteAiVisibilityData, required
    - `total_ai_crawls` number, required: Total number of requests from AI bots in the range
    - `total_ai_referrals` number, required: Total number of requests from AI platform referrers
    - `unique_ai_visitors` number, required: Distinct visitor IPs arriving from AI platforms
    - `citation_to_click_ratio` number, required: referrals / crawls. Rough signal for how effectively AI citations turn into visits. 0 if no crawls in range.
    - `top_ai_bots` AiBotMetric[], required: Top AI bots by request count
      - `bot` string, required: Canonical AI bot name
      - `purpose` 'live_user' | 'search_index' | 'crawler', required: Why the bot fetched the page. 'live_user' = live answer-time fetch for a human prompt (best citation signal). 'search_index' = AI answer-time retrieval index crawl. 'crawler' = bulk training ingest.
      - `requests` number, required: Number of requests from this bot
      - `visitors` number, required: Distinct visitor IPs (proxy for unique sessions)
    - `top_ai_referrers` AiReferrerMetric[], required: Top AI platforms by referral count
      - `platform` string, required: Canonical AI platform bucket (chatgpt, perplexity, claude, ...)
      - `requests` number, required: Number of requests from this platform
      - `visitors` number, required: Distinct visitor IPs
    - `top_cited_pages` AiCitedPageMetric[], required: Pages that draw the most AI attention (crawls + referrals)
      - `path` string, required: URL path
      - `ai_crawls` number, required: Number of requests from AI bots
      - `ai_referrals` number, required: Number of requests from AI platform referrers
    - `ai_traffic_over_time` AiTrafficDataPoint[], required: Daily or hourly time series of crawls and referrals
      - `timestamp` string, required: Bucket start (hourly or daily depending on range)
      - `ai_crawls` number, required: AI bot requests in this bucket
      - `ai_referrals` number, required: AI referral requests in this bucket

## Other responses

- `401`: Unauthorized - invalid or missing API key
- `404`: Website not found
- `500`: Internal server error

---

[API](https://skmtc.dev/lindo/apis/lindo-unified-api.md) · [All operations](https://skmtc.dev/lindo/apis/lindo-unified-api/llms.txt) · [OpenAPI document](https://skmtc.dev/lindo/apis/lindo-unified-api/revisions/2672f34525a4?raw)