Backlink API
Pull a domain's backlink profile summary — total backlinks, referring domains, domain rank, spam score, and the dofollow/nofollow split.
backlinks:readOne request, structured JSON back
curl -X POST https://instarankseo.com/api/v1/backlinks \
-H "X-API-Key: isk_your_key_here" \
-H "Content-Type: application/json" \
-d '{"domain": "example.com"}'{
"success": true,
"domain": "example.com",
"summary": {
"totalBacklinks": 1820, "referringDomains": 412, "domainRank": 38,
"spamScore": 12, "dofollowCount": 1400, "nofollowCount": 420
},
"distributions": { "tldDistribution": { "com": 900 },
"countryDistribution": { "US": 700 } },
"meta": { "creditsUsed": 50, "creditsRemaining": 18950, "apiVersion": "1.0" }
}Parameters
| Field | Type | Required | Description |
|---|---|---|---|
| domain | string | required | Target domain (hostname or URL). |
Built for builders
Whole-profile snapshot
Total backlinks, referring domains, referring IPs, domain rank, and spam score in one response — the headline link metrics at a glance.
Link quality breakdown
See the dofollow vs. nofollow split plus UGC and sponsored counts to judge link-profile health, not just raw volume.
Distributions included
Link types, platform types, TLD, country, and semantic-location distributions ship in the same call for deeper analysis.
Pricing & limits
Price
$0.05 per domain
50 credits per domain
Billed from one credit wallet. Failed upstream calls are refunded automatically.
Rate limits
- Free10 / min
- SEO+60 / min
- Agency120 / min
Surfaced as X-RateLimit-* headers on every response.
Errors
Every non-2xx shares one envelope with a machine-readable code, a retryable flag, and a requestId for tracing.
Send an Idempotency-Key header to retry POSTs safely without double-charging.
A complete backlink-profile summary for a nickel a domain — no seat-based subscription, no per-tool minimum.
Last updated:
Backlink API FAQ
Common questions about the Backlink API — pricing, auth, and what it returns.
What does the Backlink API return?
A summary of a domain's backlink profile: total backlinks, referring domains and main domains, referring pages and IPs, domain rank, spam score, broken backlinks, and the dofollow / nofollow / UGC / sponsored split — plus distributions by link type, platform, TLD, and country.
How much does it cost?
Fifty credits per domain, which is $0.05 at the standard rate. If the upstream data provider is unavailable the credit is refunded automatically.
Does it return individual backlinks?
This endpoint returns the profile summary and distributions, which is what most monitoring and qualification workflows need. It is designed to be fast and cheap to call across many domains.
What is domain rank?
Domain rank is a 0–1000 authority signal for the domain based on the quality and quantity of its backlinks — a quick proxy for how much link equity a site carries.
Which scope is required?
The backlinks:read scope on your API key, sent in the X-API-Key header.