What you can access
The API is read-only. It can read your workspace data, but it cannot create, edit or delete anything. To make changes from outside the app, such as adding or archiving prompts, use the MCP Server. If you need write access through the API itself, contact team@kime.ai. You can read:
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.
- Open the workspace switcher at the top of the sidebar and go to Organization Settings > API keys.
- Click Create API Key and give it a name.
- Copy the key. It is shown only once.
If API access isn’t enabled for your organization yet, the API keys page shows Request API access. Email team@kime.ai and the team will set you up.
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: