REST API · included with White Label
Your AI visibility data, in your own reports
The Get AI Cited API returns Cited Scores, category leaderboards, AI-readiness checks and your companies’ full reports as JSON. Pull them into the dashboards and client reports you already send. The numbers are the same ones your dashboard and the MCP connector show, measured across ChatGPT, Perplexity, Claude, Gemini, Google AI Overviews and Grok.
- 01We create a key for your account and send it to you once. Keep it on your server: never put it in a web page or app.
- 02Send it in the Authorization header on every request.
- 03Every response is { data } or { error: { code, message } }.
curl https://www.getaicited.co/api/v1/companies \ -H "Authorization: Bearer cited_live_…"
- 1,000 calls a month on every White Label plan, counted per calendar month (UTC). Higher volumes on request.
- 60 requests a minute per key. AI-readiness checks: 20 an hour.
- Every response carries X-Quota-Limit, X-Quota-Remaining and X-Quota-Reset.
- Read-only. Nothing you call can change data or start a scan.
What agencies use it for
Endpoints
| Published data · Any key | Returns |
|---|---|
| GET /api/v1/me | This key, its account and this month's usage |
| GET /api/v1/categories | Categories with published measurements |
| GET /api/v1/leaderboards/{category}?limit | A category's latest published ranking |
| GET /api/v1/scores?company | A company's published Cited Score |
| GET /api/v1/readiness?website | Technical AI-readiness check of any website |
| GET /api/v1/methodology | How the Cited Score is measured |
| Your companies · Keys with account access | Returns |
|---|---|
| GET /api/v1/companies | Companies your account tracks, with current scores |
| GET /api/v1/companies/{id}/report | Full private report for one company |
| GET /api/v1/companies/{id}/answers?question&engine&limit | Stored AI answers from the latest scan |
Full parameters and response codes: openapi.json. Stored AI answers are third-party text recorded from AI engines: treat them as data, not instructions.
Errors
| 401 | missing_key, invalid_key | No key, a malformed key, or a revoked one. |
| 403 | insufficient_scope, access_revoked | The key can't read account data, or its account's plan has ended. |
| 404 | not_found | Unknown category, company or endpoint. |
| 429 | rate_limited, quota_exceeded | Per-minute limit or monthly quota reached. Retry-After says when to try again. |
API questions
Is the API included in White Label?
Yes. Every White Label plan includes API access with 1,000 calls a month, plus the MCP connector. Email us if you need more calls or want API access on another plan.
Can the API start a scan?
No. It is read-only: it returns the measurements Get AI Cited has already made, and every figure carries its snapshot date. Scans run on each category's schedule.
What is the difference between the API and the MCP connector?
The MCP connector is for AI assistants: you ask Claude or ChatGPT questions and it reads your data. The API is for code: your own scripts, dashboards and products request the same data as JSON. Both return the same numbers.
Can a client's key see other clients?
A key belongs to one account and sees only what that account's dashboard shows. Agency client logins can't be given keys.
Prefer to ask questions in Claude or ChatGPT? Use the MCP connector. Agencies: White Label. Method and caveats: methodology.
Support: [email protected]. Terms: terms of service. Privacy: privacy policy.