Introduction - RankRaft AI Knowledge Base

The RankRaft AI REST API gives you the same data as the dashboard — Visibility Score, competitors, citations, sentiment, the stored answers, AI crawler and referral traffic, and Action Center cards — plus management of the prompts RankRaft asks the engines every day.

The REST API is part of the Enterprise plan. An owner of your organization creates keys in the dashboard under Settings → API & AI assistants. On every paid plan you can also connect Claude, ChatGPT and other assistants through the MCP server.

Base URL

https://api.rankraft.ai

Every endpoint is versioned under /v1. We add fields and endpoints without changing the version; anything that would break an integration gets a new version and advance notice in the changelog.

SDKs

Official clients handle pagination, retries and typed errors for you:

npm install rankraft-js

pip install rankraft-py

See SDKs. Building with an AI coding agent? Install the RankRaft skill so it writes correct RankRaft code.

Your first request

curl https://api.rankraft.ai/v1/sites \
  -H "X-API-Key: $RANKRAFT_API_KEY"

{
  "data": [
    {
      "id": "3f2c9a10-7b1e-4c55-9d2a-1a2b3c4d5e6f",
      "name": "Misali Foods",
      "domain": "misalifoods.com",
      "platforms": ["ai_overviews", "ai_mode", "chatgpt", "gemini", "claude"],
      "last_answer_scan": { "date": "2026-10-15", "status": "complete" }
    }
  ]
}

Then ask for your Visibility Score over the last month:

curl -X POST https://api.rankraft.ai/v1/reports/visibility \
  -H "X-API-Key: $RANKRAFT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "site_id": "3f2c9a10-7b1e-4c55-9d2a-1a2b3c4d5e6f", "start_date": "2026-09-16", "end_date": "2026-10-15" }'

What you can do

Discovery

Your key, sites, competitors and engines.

Prompts

List, add, recategorise and switch prompts on or off.

Reports

Visibility, citations, sentiment and the answers themselves.

Agent Analytics

AI crawler and AI referral traffic from your server logs.

OpenAPI

The full specification is public at https://api.rankraft.ai/v1/openapi.json. It is generated from the same schemas that validate requests, so it is always exact — import it into Postman, Insomnia or a client generator.

​Base URL

​SDKs

​Your first request

​What you can do

Discovery

Prompts

Reports

Agent Analytics

​OpenAPI

Base URL

SDKs

Your first request

What you can do

OpenAPI