Skip to content

API

REST API

Pull your CitationLab data into your own dashboards, reports and workflows — and write back to it. The REST API exposes the same modules and operations as our MCP connector, as plain HTTP with an API key.

01

Base URL

Every request goes to the AI Marketing Manager host. Responses are JSON.

https://manager.citationlab.ai/api/v1

02

Authentication

Create an API key under Settings → API in AI Marketing Manager. Keys start with mm_ and are sent in a header on every request:

  • X-Api-Key: mm_… — or Authorization: Bearer mm_…
  • A key is either read-only or read & write, and only reaches the projects your user can reach.
  • API access depends on your plan. A key can be revoked at any time.

03

How it is organised

The API is grouped into modules (project, keywords, AI Monitor, analytics, ads, CMS, actions and more). Each module has operations, and the HTTP method says what kind of operation it is:

  • GET — read. Arguments go in the query string.
  • POST — write. Arguments go in a JSON body.
  • DELETE — delete. Arguments in the body or the query string.

Endpoints

  • GET/modules
  • GET/modules/{module}
  • GET/modules/{module}/{operation}
  • POST/modules/{module}/{operation}
  • DELETE/modules/{module}/{operation}
  • GET/openapi.json

GET /openapi.json returns an OpenAPI 3.1 description of every operation and its arguments — import it into Postman, generate a client, or hand it to an agent. Partner Portal operations live under /api/v1/partner.

04

Examples

List the projects your key can reach

curl "https://manager.citationlab.ai/api/v1/modules/project/projects" \
  -H "X-Api-Key: mm_YOUR_API_KEY"

Get a project summary (a project's id is its token)

curl "https://manager.citationlab.ai/api/v1/modules/project/summary?projectId=YOUR_PROJECT_TOKEN" \
  -H "Authorization: Bearer mm_YOUR_API_KEY"

05

Rate limits

Requests are limited per API key per minute. Every response carries an X-RateLimit-Limit header; above the limit you get HTTP 429 with a retry time. The ceiling depends on your plan — contact us if you need more.

06

Working with an AI assistant instead?

Connect Claude, ChatGPT or Cursor directly with our MCP connector — no code, and no key to copy.

MCP connector →

Need API access or higher limits?

Talk to us about API access, integrations and custom data feeds.

Was this page helpful?