Competitive researchGET$0.10
/v1/backlinks
Link profile in one call: totals, domain rank, broken links, and the top referring domains.
Two vendor requests in one paid call: the summary (total backlinks, referring domains, domain rank, broken links, nofollow share) and the loudest referring domains with their own rank and first-seen date. The link-prospecting starting point: who links to a competitor and not to you.
Parameters#
| Name | Description | |
|---|---|---|
domain | required | hostname to profile, e.g. example.com |
limit | optional | referring domains to return, 1–25 (default 10) |
Request#
Plain GET. Without a payment header the response is a 402 carrying the price; an x402 client pays and retries on its own — see the quickstart.
GET https://citable.run/v1/backlinks?domain=example.com
Response#
200 with the JSON below (trimmed) and the settlement signature in the PAYMENT-RESPONSE header. Every paid response also carries price and cluster.
{
"domain": "example.com",
"summary": { "backlinks": 1930, "referringDomains": 128, "referringMainDomains": 120, "domainRank": 312, "brokenBacklinks": 4, "nofollow": 22, "firstSeen": "2023-01-05" },
"referringDomains": [
{ "domain": "news.io", "backlinks": 240, "rank": 410, "firstSeen": "2024-02-02" },
{ "domain": "blog.dev", "backlinks": 96, "rank": 350, "firstSeen": "2023-11-18" }
],
"source": "dataforseo_backlinks",
"price": "$0.10",
"cluster": "mainnet"
}Errors#
Any non-200 cancels the payment — errors are free.
| Status | Code | When |
|---|---|---|
| 400 | invalid_domain | domain is not a hostname |
| 502 | upstream_failed | the data source did not answer — nothing is charged |
| 503 | not_configured | this deployment has no credentials for the source — nothing is charged |
MCP tool#
The same call from Claude, Codex or Cursor once citable-mcp is installed. Arguments mirror the parameters above.
citable_backlinks(domain, limit?) $0.10Source & latency#
| Data source | Typical latency |
|---|---|
| DataForSEO Backlinks | ~3–8 s |
Note