“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

  1. Create a key rk_... at https://app.ranki.co/api/.
  2. Send it with every request in the header Authorization: Bearer rk_TU_CLAVE.
  3. 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

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.