List All Referring Domains
List every domain that links to a domain, with its Site Strength, page by page or as one CSV or JSONL file.
Parameters
Headers
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
Authorization | string | Yes | – | Bearer followed by your API key. See Authentication. |
Path parameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
domain | string | Yes | – | The domain, such as example.com. Case is ignored, a leading www. is removed, and a full URL is read as its host. URL-encode it in the path. |
Query parameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
limit | integer | No | 100 | Rows per page, 1–1,000. |
cursor | string | No | – | The nextCursor of the previous page. Leave it out for the first page. |
minSiteStrength | integer | No | 0 | Only domains with at least this Site Strength, 0–100. |
sort | string | No | strength_desc | strength_desc (strongest first) or strength_asc. |
format | string | No | json | json, or csv or jsonl to download the whole list in one answer (no cursor). |
Response
| Field | Type | Description |
|---|---|---|
domain | string | The domain you asked about. |
inGraph | boolean | Only when the domain isn't in our link graph yet: false, with an empty list. Absent otherwise. |
crawlRelease | string | The web graph release the list comes from, such as 2026-may-jun-jul. |
asOf | string | The release date (UTC). |
buildId | string | The index build. A cursor only works with the build it came from. |
siteStrengthVersion | string | The Site Strength scoring version. |
totalGraphRelationships | integer | How many domains are in the whole list, before minSiteStrength. |
evidenceCoverage | string | domain-graph: domain-to-domain links. Source page URLs and anchor text are not part of this list. |
sort | string | The order used. |
minSiteStrength | integer | The filter used. |
referrers | array | This page's domains, each {domain, siteStrength}. siteStrength is null when the domain has no score. |
nextCursor | string | null | Pass it as cursor for the next page. null on the last page. |
The answer also carries source, and publishedSummaryCount with countReconciled: whether totalGraphRelationships matches the count in Get Referring Domains.
Page through the list
Request the first page, then pass each nextCursor back as cursor until it is null. Keep minSiteStrength and sort the same on every page: a cursor is tied to them and to the release, and a changed filter answers 400 (start again without cursor).
Download the whole list
Add format=csv or format=jsonl to get every row in one answer, as a file download (Content-Disposition: attachment). CSV columns: domain, siteStrength, crawlRelease, asOf, evidenceCoverage.
When the domain has more than 50,000 referring domains, the answer is 202 with an export job instead: follow it as in Get an export job.
Errors
| Status | When |
|---|---|
| 400 | The domain is not a valid domain name, or a parameter is out of range. |
| 401 | No valid API key. |
| 429 | Too many requests at once; wait for Retry-After. |
| 502 | The graph lookup behind the API failed. Retry later. |
| 503 | The graph index is unavailable for a moment. Retry after Retry-After. |
Limits
No per-key limits. When the server is busy you get 429 with Retry-After. File downloads over 50,000 rows become export jobs, one at a time per key.
MCP
On the MCP server, the tool for this is list_referring_domains.