# SE Ranking

> SE Ranking is an SEO platform with a REST Data API (credit-billed SEO datasets), a Project API (SEO project/rank-tracking workflows), an SE Visible AI-visibility API, and a hosted remote MCP server exposing 217 tools. Coverage is 5.4B keywords, 2.2B domain profiles and 188+ regions. Generated by API Evangelist from https://github.com/api-evangelist/se-ranking — SE Ranking does not publish an llms.txt (https://seranking.com/llms.txt returns 404, probed 2026-08-13).

## Agent surfaces

- [MCP server](https://api.seranking.com/mcp): Hosted remote Streamable-HTTP MCP server. 217 tools and 5 prompts. `tools/list` and `prompts/list` answer anonymously; `tools/call` needs a token.
- [MCP setup docs](https://seranking.com/api/mcp/): `claude mcp add --transport http se-ranking https://api.seranking.com/mcp`
- [Agent Skills](https://github.com/seranking/seo-skills): 32 Agent Skills published by SE Ranking (MIT) for the MCP server — content briefs, AI-search share of voice, audits, backlink gaps, keyword clusters, schema, sitemap, GEO.
- [Marketing + content plugins](https://github.com/seranking/marketing-automation-plugins): further Claude/Cursor plugin bundles.

## APIs

- [Data API](https://seranking.com/api/data/reference/): Keyword research, backlinks, domain and competitor analysis, SERP, website audit, AI search. Base `https://api.seranking.com`, all paths under `/v1/`. Credit-billed.
- [Project API](https://seranking.com/api/project/): Projects, keywords, competitors, audits, backlinks, AI Results Tracker prompts, sub-accounts. Consumes plan limits, not credits. Business/Enterprise plans only.
- [SE Visible](https://api.seranking.com/mcp): AI/LLM visibility projects, brands, prompts, topics. Exposed through MCP (`SEV_*` tools) only.

## Specs

- [OpenAPI 3.0.0 — Data API (upstream)](https://raw.githubusercontent.com/seranking/openapi/main/openapi/data-api.yaml): 64 paths, 86 operations. Published by SE Ranking.
- [OpenAPI — as harvested](https://raw.githubusercontent.com/api-evangelist/se-ranking/refs/heads/main/openapi/_original/se-ranking-data-api-openapi.yml)
- [MCP tools/list — verbatim](https://raw.githubusercontent.com/api-evangelist/se-ranking/refs/heads/main/mcp/se-ranking-mcp-tools.json): the only machine-readable contract for the Project API and SE Visible surfaces, which have no OpenAPI.
- [MCP tool crosswalk](https://raw.githubusercontent.com/api-evangelist/se-ranking/refs/heads/main/mcp/se-ranking-tool-crosswalk.yml): every MCP tool bound to its backing OpenAPI operation.

## Docs

- [Getting started — Data API](https://seranking.com/api/data/getting-started/)
- [Getting started — Project API](https://seranking.com/api/project/getting-started/)
- [Authentication](https://seranking.com/api/data/authentication/): `Authorization: Token YOUR_API_KEY` (prefix is `Token`, not `Bearer`), or `?apikey=`.
- [Rate limits](https://seranking.com/api/rate-limits/): 10 rps Data API, 5 rps Project API, 1 rps trial — per API key, rolling one-second window, 429 on exhaustion. No rate-limit response headers are published.
- [Credits system](https://seranking.com/api/api-credits-system/): per-record and per-request billing; 4xx/5xx are never billed.
- [Pricing](https://seranking.com/api-pricing.html)
- [Postman workspace](https://www.postman.com/serankingdev/se-ranking-developers/overview)
- [Status page](https://status.seranking.com)
- [Release timeline](https://seranking.com/whats-new.html)

## Known gaps (measured 2026-08-13)

- No idempotency contract on any surface, including 151 mutating MCP tools.
- No response schemas in the OpenAPI — zero `components.schemas`, and only `200` responses declared on all 86 operations.
- No RFC 9457 problem details; errors use `{"error":{"code","message","description"}}`.
- No `security.txt`, no trust center, no published certifications, no deprecation or sunset policy.
- No A2A agent card on either host.
- No first-party client SDK on any language registry — the MCP server and an n8n node are the distribution.