API Overview
SeeLLM's REST API gives you programmatic access to all your AI traffic analytics data.
Base URL
https://api.seellm.com/api
Authentication
All API requests require authentication via one of:
- Firebase Auth Token —
Authorization: Bearer <firebase_jwt> - API Key —
Authorization: Bearer sk_live_...
API keys can be generated in your dashboard under Settings > API Keys.
Common Query Parameters
All analytics endpoints support these parameters:
| Parameter | Type | Default | Description |
|---|---|---|---|
range | 7d | 30d | 90d | 30d | Predefined date range |
start_date | YYYY-MM-DD | — | Custom start date (overrides range) |
end_date | YYYY-MM-DD | — | Custom end date (overrides range) |
domain | string | — | Filter by domain |
short_code | string | — | Filter by short code |
Response Format
All endpoints return JSON. Successful responses return the data directly. Errors return:
{
"error": "Unauthorized",
"message": "Invalid authentication token"
}
Rate Limits
- 60 requests/minute per authenticated user
- 100 requests/minute for the dashboard endpoint
- Rate limit headers:
X-RateLimit-Limit,X-RateLimit-Remaining,X-RateLimit-Reset
Caching
All analytics queries are cached server-side with a 5-minute TTL. This reduces backend costs by ~95% while keeping data fresh enough for dashboards.
Next Steps
- See Authentication for detailed auth setup
- Browse Analytics Endpoints for the full API reference
- Use Jobs to approve work and attach patch or edge-page implementations
- Use Agent Hooks to send signed SeeLLM jobs to your automation stack