SurfRank
How It WorksFeaturesPricing
Log InGet Started
API Reference

Build on SurfRank

The SurfRank public API exposes every capability of the platform — projects, keywords, reports, quick tests, keyword research, and opportunities — as REST endpoints with simple API key authentication.

Auth

API key via X-API-Key header

Rate limit

60 requests / minute per key

Transport

HTTPS only, TLS 1.3

Quickstart

1. Generate an API key

Open the SurfRank dashboard → API Management → Create key. Keys start with sr_.

2. Make your first request

curl https://api.surfrank.ai/api/v1/public/projects \
  -H "X-API-Key: sr_your_key_here"

3. Parse the JSON response

Every endpoint returns JSON. Errors follow { error: "...", code: "..." }.

Core endpoints

GET
/api/v1/public/projects

List all your projects

POST
/api/v1/public/projects

Create a new project

POST
/api/v1/public/projects/:id/keywords

Add keywords to track

POST
/api/v1/public/projects/:id/reports

Trigger an AI visibility report

GET
/api/v1/public/projects/:id/reports/latest

Get the latest report

POST
/api/v1/public/quick-tests

Run a quick AI visibility test

GET
/api/v1/public/keyword-research

Research AI search keywords

GET
/api/v1/public/opportunities

List content opportunities

Rate limits

  • 60 requests/min per API key
  • Exceeded limits return 429 with Retry-After
  • Tool-call quotas apply per plan

Errors

  • 400 — malformed request or missing params
  • 401 — missing or invalid API key
  • 402 — plan limit reached
  • 429 — rate limit exceeded
New

Use SurfRank from inside Claude, Cursor, and ChatGPT

Every API endpoint is also exposed as an MCP (Model Context Protocol) tool. Wire SurfRank into any MCP-compatible AI client in under a minute.

See MCP setup

Ready to build?

Grab an API key from your dashboard and start hitting the endpoints. Questions? Our team answers every dev email.

Get API keyFull docs