Analytics Endpoints

Complete reference for SeeLLM's analytics API endpoints.

Dashboard (Combined)

GET /api/analytics/dashboard

Returns all key metrics in a single request. Recommended for dashboard loading — avoids multiple round trips.

curl "https://api.seellm.com/api/analytics/dashboard?range=30d" \
  -H "Authorization: Bearer sk_live_..."

Returns overview, timeSeries, aiSources, devices, topLinks, and more in one response.

Traffic

GET /api/analytics/traffic-overview

Total visits, human clicks, AI visits, and AI percentage.

{
  "total_visits": 42557,
  "human_clicks": 38771,
  "ai_visits": 3786,
  "ai_percentage": 8.9
}

GET /api/analytics/weekly-trend

Week-by-week breakdown with per-platform AI detail.

{
  "weekly": [
    { "week": "2026-03-17", "total_visits": 8631, "human_visits": 7645, "ai_visits": 986, "ai_pct": 11.4 }
  ],
  "byPlatform": [
    { "week": "2026-03-17", "ai_source": "chatgpt", "visits": 174 }
  ]
}

GET /api/analytics/time-series

Daily time series of visits (total, human, AI, mobile, desktop).

AI Sources

GET /api/analytics/ai-sources

Breakdown of traffic by AI platform with visit counts and percentages.

GET /api/analytics/ai-platform-market-share

Market share analysis across AI platforms (excludes scrapers, only "Search AI" traffic).

GET /api/analytics/developer-tools

Traffic from developer-focused AI tools (Cursor, GitHub Copilot, etc.).

GET /api/analytics/dev-tools-adoption

Developer tools adoption metrics.

GET /api/analytics/ai-confidence

AI detection confidence distribution.

Content & Pages

GET /api/analytics/top-links

Top performing links by visit count.

GET /api/analytics/ai-to-human-conversion

AI-to-human conversion funnel data.

GET /api/analytics/traffic-value-breakdown

Estimated traffic value broken down by type.

Devices & Geography

GET /api/analytics/devices

Device type breakdown (desktop, mobile, tablet, bot).

GET /api/analytics/operating-systems

OS distribution across visits.

GET /api/analytics/browsers

Browser distribution.

GET /api/analytics/device-by-ai-source

Cross-tabulation of device types by AI source.

GET /api/analytics/geographic

Geographic distribution of visits.

Time Patterns

GET /api/analytics/hourly-activity

Hourly distribution of visits.

GET /api/analytics/daily-activity

Day-of-week distribution.

GET /api/analytics/peak-times

Peak traffic times analysis.

GET /api/analytics/weekend-vs-weekday

Weekend vs weekday traffic comparison.

Campaigns & Referrals

GET /api/analytics/utm-campaigns

UTM campaign performance.

GET /api/analytics/referrers

Referrer breakdown.

Domain & Bot Analysis

GET /api/analytics/domain-breakdown

Traffic breakdown by domain (for multi-domain setups).

GET /api/analytics/bot-traffic

Bot traffic list with detailed classification.

Utility

GET /api/analytics/filter-values

Available filter values for the current organization.

GET /api/analytics/cache-stats

Server-side cache performance metrics.