Skip to Content

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. Data calls are paid per call with credits: new accounts get 100 free, purchased credits never expire, and the optional Pro and Agency plans add a monthly credit quota plus the workflow features (rank tracking, outreach, AI visibility scans, client reports). See Credits.

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-audit and page-seo to score a site's links and on-page health in a few calls.
  • Link building tools. Find prospects with link-intersect, domain-overlap and competitor-gap: the sites that link to your competitors but not to you.
  • Lead and market research. Use platform-domains and tech-stack to 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. See Rank tracking.
  • Website health for agents. List the problems on your websites with Issues, read stored Google index status with Indexing, check how ready a website is for AI search agents with the AI visibility scan, crawl it for broken links, redirects, duplicates and sitemap gaps with a site audit, and keep what each website is about in project context so agents do not start from nothing.
  • 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.

GroupEndpointsCredits
Authoritydomain-authority, domain-rank1, 2
Link graphbacklinks, referring-domains, outbound-links, anchor-text, top-pages2 each (3 for backlinks and referring-domains with score=true)
Competitive analysisdomain-overlap, link-intersect, similar-domains, competitor-gap5 each
Auditslink-audit, site-explorer8, 10
Live page checkspage-seo, page-performance, schema-markup, tech-stack, site-health, sitemap, crawl-history3, 3, 2, 2, 2, 2, 2
Platform dataplatform-domains, platform-trends1 per domain returned, 1
Bulkbatch2 per successful domain
Indexingindexnow, indexnow/key1, free
Rank tracking/v1/rank-tracking/*Free
Search Console/v1/gsc/*Free
Issues and indexing/v1/issues, /v1/indexingFree
AI visibility scan/v1/site-scan, /v1/site-scan/recheckFree, paid plans and verified websites only
Site audit/v1/site-audit, /v1/site-audit/run, /v1/site-audit/issues, /v1/site-audit/pagesFree, paid plans and verified websites only
Project context/v1/site-contextFree
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-reportFree
Outreach/v1/outreach/*Free
Free tools/v1/tools/*Free, daily allowance
Account/v1/credits, /v1/me, /v1/keys, /v1/usage, /v1/pricingFree
LinkedIn automation (Zeekeo)/v1/zeekeo/*Free, needs a connected Zeekeo account
Not yet availablelink-velocity, new-links, lost-links, internal-linksFree

How data is sourced

SourceUsed byFreshness
Link graph snapshotLink graph, authority, anchor text, top pages, competitive endpointsA point in time. The current snapshot is cc-main-2026-jan-feb-mar.
Live fetchpage-seo, tech-stack, site-health, sitemap, schema-markupReal time, on every call.
Google PageSpeed Insightspage-performanceCached for 24 hours per URL and strategy.
Your connected accountsRank tracking, Search Console, Google Ads, issues, indexingSearch Console and Google Ads are live calls; rank tracking, issues and indexing are as recent as the last background sync (about daily).
Daily background scanAI visibility scanOnce a day per verified website, or on a re-check.
Background crawlSite auditWhen you start one: a few minutes for a few hundred pages. The 3 newest are kept.

Conventions

  • Authentication. Send X-API-Key: rp_... on every request. See Authentication.
  • Domains. Pass bare hostnames such as stripe.com, not URLs.
  • Pagination. limit defaults to 100 and is clamped to 1000 on most endpoints. Each operation page gives its exact limits.
  • Empty data. A domain with no data returns 200 with data: [], never 404.
  • 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. They wrap the link graph, live page and account endpoints; everything else is called over plain HTTP with the same key.

On this page