> ## Documentation index
> Fetch the complete documentation index at: https://rankfield.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

`GET https://rankfield.dev/v1/domains/{domain}/referrers`

```bash cURL
curl 'https://rankfield.dev/v1/domains/wikipedia.org/referrers?limit=3' \
  -H 'Authorization: Bearer YOUR_API_KEY'
```

```python Python
import requests

response = requests.get(
    "https://rankfield.dev/v1/domains/wikipedia.org/referrers?limit=3",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)
print(response.json())
```

```javascript JavaScript
const response = await fetch("https://rankfield.dev/v1/domains/wikipedia.org/referrers?limit=3", {
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
  },
});
console.log(await response.json());
```

```json 200
{
  "domain": "wikipedia.org",
  "crawlRelease": "2026-may-jun-jul",
  "buildId": "graph-2026mayjunjul-v3",
  "asOf": "2026-08-19T00:00:00Z",
  "source": "Rankfield web graph",
  "siteStrengthVersion": "authority-continuous-counts-0.3.1",
  "totalGraphRelationships": 2154598,
  "publishedSummaryCount": 2154598,
  "countReconciled": true,
  "evidenceCoverage": "domain-graph",
  "sort": "strength_desc",
  "minSiteStrength": 0,
  "referrers": [
    { "domain": "adobe.com", "siteStrength": 100 },
    { "domain": "amazon.com", "siteStrength": 100 },
    { "domain": "amazonaws.com", "siteStrength": 100 }
  ],
  "nextCursor": "eyJ2IjoxLCJkb21haW4iOiJ3aWtpcGVkaWEub3JnIiwiZGlyZWN0aW9uIjoiaW5ib3VuZCIsInJlbGVhc2UiOiIyMDI2LW1heS1qdW4tanVsIiwiYnVpbGRJZCI6ImdyYXBoLTIwMjZtYXlqdW5qdWwtdjMiLCJhc09mIjoiMjAyNi0wOC0xOVQwMDowMDowMFoiLCJtaW5TaXRlU3RyZW5ndGgiOjAsInNvcnQiOiJzdHJlbmd0aF9kZXNjIiwicG9zaXRpb24iOjN9.488e7b22c11bc97ca2bf07159ab6406d7dbb326ace55b098cb233387413ea504"
}
```

```csv 200 CSV
domain,siteStrength,crawlRelease,asOf,evidenceCoverage
vercel.app,89,2026-may-jun-jul,2026-08-19T00:00:00Z,domain-graph
it.com,88,2026-may-jun-jul,2026-08-19T00:00:00Z,domain-graph
langchain.com,75,2026-may-jun-jul,2026-08-19T00:00:00Z,domain-graph
```

## Parameters

### Headers

| Name | Type | Required | Default | Description |
|---|---|---|---|---|
| `Authorization` | string | Yes | – | `Bearer` followed by your API key. See [Authentication](/docs/get-started/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](/docs/referring-domains/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](/docs/referring-domains/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](/docs/referring-domains/start-an-export-job), one at a time per key.

## MCP

On the [MCP server](/docs/agents/mcp-server), the tool for this is `list_referring_domains`.