List the unique domains that link to a target domain, with dofollow and nofollow link counts.

GET/v1/referring-domains2 credits (3 credits with score=true)API key

Returns one row per domain that links to the target, ranked by total number of links. Use it to size a link profile, find your strongest linkers, or feed a prospecting list. Data comes from the pre-processed link graph snapshot (see Response format).

Request

Parameters

Parameter	Type	Required	Default	Description
`domain`	string	Yes	none	Domain to query, for example `stripe.com`. No scheme or path. Must contain a dot.
`limit`	integer	No	`100`	Number of rows to return. Clamped to 1 to 1000. A non-numeric value falls back to `100`.
`score`	boolean	No	`false`	Send `score=true` to add `from_domain_score` (0 to 100) to every row. Costs 3 credits instead of 2. Only the exact value `true` enables it.

This endpoint does not support offset. Raise limit (up to 1000) to see more rows.

Example

curl "https://api.rankparse.com/v1/referring-domains?domain=stripe.com&limit=50&score=true" \
  -H "X-API-Key: rp_your_key"

import requests

res = requests.get(
    "https://api.rankparse.com/v1/referring-domains",
    params={"domain": "stripe.com", "limit": 50, "score": "true"},
    headers={"X-API-Key": "rp_your_key"},
    timeout=90,
)
res.raise_for_status()
for row in res.json()["data"]:
    print(row["from_domain"], row["total_links"], row["from_domain_score"])

const params = new URLSearchParams({ domain: "stripe.com", limit: "50", score: "true" });

const res = await fetch(`https://api.rankparse.com/v1/referring-domains?${params}`, {
  headers: { "X-API-Key": "rp_your_key" },
});
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const { data } = await res.json();
console.log(data);

Response

{
  "domain": "stripe.com",
  "data": [
    {
      "from_domain": "wikipedia.org",
      "dofollow_links": 42,
      "nofollow_links": 3,
      "total_links": 45,
      "from_domain_score": 98
    },
    {
      "from_domain": "techcrunch.com",
      "dofollow_links": 31,
      "nofollow_links": 0,
      "total_links": 31,
      "from_domain_score": 91
    }
  ],
  "total": 2,
  "limit": 50,
  "credits_used": 3,
  "credits_remaining": 996
}

Response fields

Top level:

Field	Type	Description
`domain`	string	The normalized (lowercased) domain you queried.
`data`	array	One row per referring domain, sorted by `total_links` descending. Empty when the domain has no data.
`total`	integer	Number of rows returned in `data`. It is not the all-time count of referring domains.
`limit`	integer	The `limit` value you sent, echoed back as received.
`credits_used`	integer	`2`, or `3` with `score=true`.
`credits_remaining`	integer	Your balance after this call.

Each row in data:

Field	Type	Description
`from_domain`	string	The linking domain.
`dofollow_links`	integer	Links from this domain without a `nofollow` style `rel`.
`nofollow_links`	integer	Links from this domain marked `nofollow`.
`total_links`	integer	Total links from this domain to the target.
`from_domain_score`	integer	Only with `score=true`. Authority score (0 to 100) of the linking domain, `0` when unknown. See Domain Authority.

Behavior and limits

Credits: 2 per call, 3 with score=true, charged before the lookup. If the lookup fails with a server error, the credits are refunded.
Caching: results are cached for 30 days per crawl release and per combination of domain, limit and score. A cache hit is billed the same as a fresh lookup.
Empty results: a domain with no data returns 200 with data: [], never 404.
Rate limit: 60 requests per minute per key. See Rate limiting.

Errors

HTTP	Code	When
400	`invalid_domain`	`domain` is missing or not a valid domain. Returned before any charge.
401	`invalid_api_key`	Missing, invalid or revoked API key.
402	`insufficient_credits`	Balance is lower than the call cost.
402	`spend_cap_reached`	Your monthly spend cap is reached.
429	`rate_limited`	More than 60 requests in a minute.
503	`query_timeout`, `upstream_error`	Transient data store problem. Retry after the `Retry-After` header. Credits are refunded.