What you can access
The API provides read-only access to your workspace data:
All analytics endpoints support filtering by date range, answer engine, brand, prompt, category, and tags.
Supported answer engines
Filter by any combination of:chatgpt · perplexity · claude · gemini · google-ai-overview · google-ai-mode
Authentication
The API uses API keys passed in thex-api-key header. Each key is scoped to your organization and can be restricted to specific resources.
How to get an API key
- Sign in to the Kime dashboard.
- Go to Settings → API Keys.
- Click Create API Key and give it a name.
- Copy the key — it’s shown only once.
metrics scope cannot access sources).
Making requests
All requests go to: https://api.kime.ai/v1/… Include your API key in the header:x-api-key: your_api_key_here
Example — list your workspaces:
curl -H "x-api-key: your_api_key_here" \
https://api.kime.ai/v1/workspaces
Pagination
List endpoints return paginated results. Usepage_size (max 100) and the cursor from the response to fetch additional pages.
Date filtering
Analytics endpoints default to the last 7 days. Override withstart_date and end_date query parameters (format: YYYY-MM-DD).
Error handling
Errors return RFC 9457 Problem Details format with atype, title, status, and detail field. Common codes: