“Getting Started with the API”
Welcome to the official documentation for the Ranki API.
The API lets you integrate SEO tools and your account data into scripts, apps and automations through HTTP endpoints. If you want to use Ranki from Cursor, Claude or another compatible assistant, see the separate MCP Server.
Getting started
- Create a key
rk_...at https://app.ranki.co/api/. - Send it with every request in the header
Authorization: Bearer rk_TU_CLAVE. - Choose the module and endpoint you need in this reference.
curl -s \
-H "Authorization: Bearer rk_TU_CLAVE" \
"https://api.ranki.co/v1/credits/balance"
See Authentication for accepted headers and security recommendations.
Base URLs
| API | Base URL | Use |
|---|---|---|
| Keyword Tools, Competitors and Keyword Clustering | https://api.ranki.co/v1 |
Keyword research, SERP, domain analysis and keyword clustering. |
| Ranki account data | https://app.ranki.co/wp-json/ranki/v1 |
Site Audit, Keyword Tracker and AI Tracker. |
Reference by module
| Module | API operations | Usage | Documentation |
|---|---|---|---|
| Site Audit | 4 | 0 credits; requires existing crawls | View Site Audit |
| Keyword Tools | 4 | 1 API credit; live SERP uses 3 | View Keyword Tools |
| Competitors | 4 | 1 API credit per request | View Competitors |
| Keyword Tracker | 16 | Uses your plan’s tracking quota | View Keyword Tracker |
| AI Tracker | 11 | Uses your plan’s tracking quota | View AI Tracker |
| Keyword Clustering | 6 | 1 API credit per keyword when you create a job (API credit balance). Reading and downloading: 0 | View Keyword Clustering |
Guides
- Authentication: creating and using API keys.
- Credit model: costs and limits by module.
- Error handling: HTTP codes and common fixes.
- MCP Server: OAuth connection and tool catalog for AI assistants.
Some operation names match their MCP tools, so you can use the same capability over HTTP or from an assistant. The parameters, endpoints and responses documented in the reference pages belong to the API.