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

# Get workspace AI visibility analytics

`GET /v1/workspace/analytics/ai-visibility`

## Request

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

Retrieves AI-specific traffic analytics for the workspace: how often AI crawlers (GPTBot, ClaudeBot, PerplexityBot, ...) fetch your pages, and how many human visitors arrive from AI chat platforms (ChatGPT, Perplexity, Claude, Gemini, ...). Supports optional date range filtering.

## 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

- WorkspaceAiVisibilityResponse
  - `success` true, required: Indicates the operation was successful
  - `result` WorkspaceAiVisibilityData, 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
- `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)