Rankability Agent API

The SEO platform you can program

The Rankability Agent API gives developers full access to the content engine, rank tracker, and client management system. Automate content production at scale, build custom dashboards, or integrate SEO data into any application.

See pricing Read the API docs

Create a content job

POST /api/agent/v1/copywriter/jobs
Authorization: Bearer rk_live_your_key_here
Content-Type: application/json

{
  "topic": "best project management tools for agencies",
  "intent": "discover",
  "mode": "auto"
}

// Response
{
  "id": "job_01abc123",
  "status": "queued",
  "topic": "best project management tools..."
}

API coverage

Three APIs. One platform.

Copywriter API

Create content jobs programmatically. Send a topic, intent, and optional client context — the API runs the full research and drafting pipeline. Retrieve structured artifacts: outline, HTML draft, SEO metadata (title tag, meta description, slug), NLP entities, FAQ schema JSON-LD, and content score. Supports auto mode (end-to-end) and stepped mode (pause at brief for review).

Reporter API

Create tracking projects with keywords, target domains, and platform selections. Trigger on-demand scans. Read SPI scores, platform-level rankings, and historical trend data. Manage tracking at scale across your entire client portfolio.

Clients API

Create, update, and list client profiles. Set domains, icons, colors, and knowledge base entries via the API. Automate client onboarding from your CRM or project management tool.

Quick start

Up and running in minutes

Create an API key

Go to Settings > API keys. Click "Create API key," name it, and select scopes. The key starts with rk_live_ and is shown exactly once — copy it immediately.

Authenticate requests

Add the key as a Bearer token in every request header:

Authorization: Bearer rk_live_your_key_here

All endpoints are under /api/agent/v1/

Create your first content job

POST /api/agent/v1/copywriter/jobs

{
  "topic": "best project management tools for agencies",
  "intent": "discover",
  "mode": "auto"
}

The API returns a job ID. Poll GET /api/agent/v1/copywriter/jobs/:id until the status is completed.

Retrieve artifacts

GET /api/agent/v1/copywriter/jobs/:id/artifacts

Returns the outline, full HTML draft, title tag, meta description, URL slug, entities, FAQs with JSON-LD, and content score breakdown.

Technical details

What you need to know

Base URL	https://api.rankability.com/api/agent/v1
Auth	Bearer token (`rk_live_` prefix)
Key storage	SHA-256 hashed; full key shown once at creation
Rate limits	30 req/min (Core) · 60 (Team) · 120 (Agency)
Idempotency	Supported via `Idempotency-Key` header
Response format	JSON
API version	Returned in `X-API-Version` header
Scopes	`copywriter:run` `copywriter:read` `reporter:read` `reporter:run` `reporter:write` `clients:read` `clients:write` `kb:read`

Use cases

What agencies build with the API

Bulk content pipelines

Feed a spreadsheet of keywords into the Copywriter API and produce dozens of optimized articles overnight.

Custom client dashboards

Pull SPI scores, keyword rankings, and content project status into your own reporting UI or BI tool.

CMS publishing automation

Chain the Copywriter API with the WordPress or Webflow export endpoint to go from keyword to published page automatically.

AI agent integration

Connect Rankability to AI coding assistants (Cursor, Windsurf, Claude Desktop) via MCP for conversational SEO workflows.

White-label reporting

Query Reporter data and format it into branded PDFs or dashboards under your agency's identity.

MCP Support

Works with AI assistants via MCP

Rankability supports Model Context Protocol (MCP), letting you connect your SEO data to Claude Desktop, Cursor, and Windsurf. Ask your assistant "How is Acme Corp performing?" or "Create a content brief for this keyword" and it pulls live data and takes action through the API. Two connection methods: hosted HTTP endpoint and local stdio transport.

"We built a custom pipeline that takes keyword research from our strategists, runs it through Rankability's API, and delivers publish-ready articles directly into our clients' WordPress sites. What used to take a week now takes a day."
— Agency team using the Rankability API

Build on Rankability

The API is available on every plan. Generate your first key in under a minute and start automating your SEO workflows today.

See pricing API documentation