Read the same figures as your dashboard from your own scripts and tools. The API is read only: it can look at your projects, but it cannot change anything.
Get a key
- Open Settings, then API keys. Only a workspace Admin can see this tab.
- Name the key and choose Generate API key.
- Copy the key straight away. It is not shown again. If you lose it, revoke it and generate a new one.
A key belongs to your workspace and reads only that workspace's projects. Revoke a key on the same tab and it stops working at once.
Send a request
Send the key as a bearer token. Every address starts with /api/v1 on the same site as the app.
For example: curl -H "Authorization: Bearer YOUR_KEY" https://app.klientbrain.ai/api/v1/projects
Start with /api/v1/projects for the project ids, then pass an id to the others.
| Address | What it returns |
|---|---|
/api/v1/projects | Your projects, with brand, engines, competitors and latest run date |
/api/v1/projects/{id} | One project |
/api/v1/projects/{id}/overview | Visibility, share of voice, position, sentiment and citation rate, each with its range, the score and results by engine |
/api/v1/projects/{id}/competitors | Every tracked brand's figures, and the prompts where competitors are named and you are not |
/api/v1/projects/{id}/prompts | Each tracked prompt with its latest result on every engine |
/api/v1/projects/{id}/answers | What AI says about the brand: sentiment, themes, answers and open inaccuracies |
/api/v1/projects/{id}/sources | The websites AI answers cite |
/api/v1/projects/{id}/fixes | The fix list, best first. Add include_closed=true for fixes marked Done or Dismissed |
Add from and to (as 2026-10-01) and engines (a comma separated list) to narrow the figures. Long lists take limit and cursor: when an answer has a nextCursor, pass it as cursor to get the next page.
Limits
Each workspace has an hourly quota that depends on its plan, plus a per-minute limit, shared by every key in the workspace. Every answer carries X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset. Past a limit the API answers 429 with a Retry-After header: wait that many seconds.
| Plan | Per hour | Per minute |
|---|---|---|
| Startup | 1,000 | 60 |
| Scale-up | 1,500 | 90 |
| Standard | 2,000 | 120 |
| Enterprise | 4,000 | 240 |
| Agency Essential | 2,000 | 120 |
| Agency Growth | 3,000 | 180 |
| Agency Scale | 4,000 | 240 |
Errors
- 401: the key is missing, wrong or revoked.
- 404: no such project in your workspace.
- 405: the API only reads. Use GET.
- 429: too many requests. See
Retry-After.
Looking for an assistant instead of a script? See Connect an AI assistant (MCP).