RankParse docs
Everything you need to build with the RankParse SEO data API and its MCP server.
RankParse is an SEO data API for developers and AI agents. It combines a link graph built from pre-processed public web data (backlinks, referring domains, anchor text, domain authority, top pages) with live page checks (on-page SEO, tech stack, site health, structured data, Core Web Vitals) and your own search data (rankings from Google, Bing and Yandex, Search Console, indexing). You call it over plain REST or through an MCP server, and you pay per call with prepaid credits. There is no subscription.
Quickstart
Get an API key and make your first call in five minutes.
Authentication
Send your X-API-Key, rotate keys and keep them safe.
API reference
Every endpoint with parameters, examples and response fields.
MCP server for AI agents
Connect Claude, ChatGPT, Claude Code or Cursor to RankParse tools.
Rank tracking
Read stored Google, Bing and Yandex keyword rankings.
Credits and pricing
Costs per endpoint, refunds, spend cap and auto recharge.
Changelog
What shipped and when.
Hello world
Base URL: https://api.rankparse.com. All endpoints live under /v1/.
curl "https://api.rankparse.com/v1/domain-authority?domain=github.com" \
-H "X-API-Key: rp_your_key"{
"data": {
"score": 94,
"referring_domains": 1203455,
"total_host_count": 2300112,
"registered_at": "2007-10-09T18:20:50Z",
"registrar": "MarkMonitor Inc.",
"popularity_rank": 31,
"health_score": 96,
"risk_flags": []
},
"domain": "github.com",
"credits_used": 1,
"credits_remaining": 99
}The values above are illustrative. Every response includes credits_used and credits_remaining; see Response format. No key yet? The Quickstart takes about two minutes, and new accounts include 100 free credits.
What you can build
- SEO dashboards and audits. Combine
site-explorer,link-auditandpage-seoto score a site's links and on-page health in a few calls. - Link building tools. Find prospects with
link-intersect,domain-overlapandcompetitor-gap: the sites that link to your competitors but not to you. - Lead and market research. Use
platform-domainsandtech-stackto list sites running a platform, enriched with authority and domain age. - AI SEO agents. Give an agent the same endpoints as MCP tools. Actions that change things, such as IndexNow submissions and outreach sends, wait in an approval inbox for a human to approve.
- Rank monitoring and client reports. Read stored keyword rankings, history and rank change alerts, and weekly client reports for the websites you track.
- Indexing automation. Submit new URLs to Bing, Yandex and other engines with IndexNow.
Endpoint groups
Costs are in credits. "Free" means 0 credits. The full per-endpoint table, with refund rules, is on Credits.
| Group | Endpoints | Credits |
|---|---|---|
| Authority | domain-authority, domain-rank | 1, 2 |
| Link graph | backlinks, referring-domains, outbound-links, anchor-text, top-pages | 2 each (3 for backlinks and referring-domains with score=true) |
| Competitive analysis | domain-overlap, link-intersect, similar-domains, competitor-gap | 5 each |
| Audits | link-audit, site-explorer | 8, 10 |
| Live page checks | page-seo, page-performance, schema-markup, tech-stack, site-health, sitemap, crawl-history | 3, 3, 2, 2, 2, 2, 2 |
| Platform data | platform-domains, platform-trends | 1 per domain returned, 1 |
| Bulk | batch | 2 per successful domain |
| Indexing | indexnow, indexnow/key | 1, free |
| Rank tracking | /v1/rank-tracking/* | Free |
| Search Console | /v1/gsc/* | Free |
| Google Ads keyword research | /v1/google-ads/* | Free, with a daily cap |
| Agent workflow | /v1/proposals, /v1/websites, /v1/agent-tasks, /v1/activity, /v1/client-report | Free |
| Outreach | /v1/outreach/* | Free |
| Free tools | /v1/tools/* | Free, daily allowance |
| Account | /v1/credits, /v1/me, /v1/keys, /v1/usage, /v1/pricing | Free |
| Not yet available | link-velocity, new-links, lost-links, internal-links | Free |
How data is sourced
| Source | Used by | Freshness |
|---|---|---|
| Link graph snapshot | Link graph, authority, anchor text, top pages, competitive endpoints | A point in time. The current snapshot is cc-main-2026-jan-feb-mar. |
| Live fetch | page-seo, tech-stack, site-health, sitemap, schema-markup | Real time, on every call. |
| Google PageSpeed Insights | page-performance | Cached for 24 hours per URL and strategy. |
| Your connected accounts | Rank tracking, Search Console, Google Ads | As recently as your last sync. |
Conventions
- Authentication. Send
X-API-Key: rp_...on every request. See Authentication. - Domains. Pass bare hostnames such as
stripe.com, not URLs. - Pagination.
limitdefaults to 100 and is clamped to 1000. - Empty data. A domain with no data returns
200withdata: [], never404. - Rate limit. 60 requests per minute per key. See Rate limiting.
- Errors. JSON with a stable
code. See Errors.
SDKs
Official clients exist for Node.js and Python. Both wrap the same REST API documented here.