Documentation

Public API (v1)

Read your CiteLens data programmatically. The public API is read-only, scoped to your organization, and available on the Pro and Agency plans.

Create a key in Organization → API keys. The full key (it starts with cl_live_) is shown only once, so copy it somewhere safe. Send it on every request in the X-API-Key header. The base URL is https://api.citelens.ai.

curl https://api.citelens.ai/v1/workspaces \
  -H "X-API-Key: cl_live_xxxxxxxxxxxxxxxxxxxxx"

Endpoints

GET/v1/workspaces

List the workspaces in your organization.

GET/v1/workspaces/{id}/visibility

Latest AI-visibility scores for a workspace (with confidence interval).

GET/v1/workspaces/{id}/citations?days=30

Cited URLs for a workspace over the last N days (1–365, default 30).

A typical flow is: call /v1/workspaces to get an id, then read that workspace’s visibility and citations. Responses are JSON; the visibility payload includes the score and its 95% confidence interval, and the citations payload mirrors the Citations screen.

curl "https://api.citelens.ai/v1/workspaces/$WS/citations?days=30" \
  -H "X-API-Key: cl_live_xxxxxxxxxxxxxxxxxxxxx"

The API is read-only by design — it surfaces your data for dashboards and reporting. Keep keys server-side, never in client code, and revoke any key from Organization → API keys the moment it leaks.

Start free