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

# Get Referrer Profile

> Get how a domain's referring domains spread across ten Site Strength ranges, counted over the complete list.

`GET https://rankfield.dev/v1/domains/{domain}/referrer-profile`

```bash cURL
curl 'https://rankfield.dev/v1/domains/wikipedia.org/referrer-profile' \
  -H 'Authorization: Bearer YOUR_API_KEY'
```

```python Python
import requests

response = requests.get(
    "https://rankfield.dev/v1/domains/wikipedia.org/referrer-profile",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)
print(response.json())
```

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

```json 200
{
  "domain": "wikipedia.org",
  "crawlRelease": "2026-may-jun-jul",
  "asOf": "2026-08-19T00:00:00Z",
  "buildId": "graph-2026mayjunjul-v3",
  "siteStrengthVersion": "authority-continuous-counts-0.3.1",
  "evidenceCoverage": "domain-graph",
  "totalGraphReferringDomains": 2154598,
  "scoreDistribution": [
    { "minSiteStrength": 0, "maxSiteStrength": 9, "referringDomains": 453583, "share": 0.21051862110704642 },
    { "minSiteStrength": 10, "maxSiteStrength": 19, "referringDomains": 820486, "share": 0.3808069997280235 },
    { "minSiteStrength": 20, "maxSiteStrength": 29, "referringDomains": 528569, "share": 0.24532140102237168 },
    { "minSiteStrength": 30, "maxSiteStrength": 39, "referringDomains": 218766, "share": 0.10153448578342689 },
    { "minSiteStrength": 40, "maxSiteStrength": 49, "referringDomains": 85750, "share": 0.039798607443244635 },
    { "minSiteStrength": 50, "maxSiteStrength": 59, "referringDomains": 33062, "share": 0.015344857834268852 },
    { "minSiteStrength": 60, "maxSiteStrength": 69, "referringDomains": 10674, "share": 0.004954056394742778 },
    { "minSiteStrength": 70, "maxSiteStrength": 79, "referringDomains": 2830, "share": 0.0013134700765525635 },
    { "minSiteStrength": 80, "maxSiteStrength": 89, "referringDomains": 700, "share": 0.0003248865913734256 },
    { "minSiteStrength": 90, "maxSiteStrength": 100, "referringDomains": 178, "share": 0.0000826140189492425 }
  ],
  "unscoredReferringDomains": 0,
  "unscoredShare": 0
}
```

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

## 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 empty ranges. Absent otherwise. |
| `crawlRelease`, `asOf`, `buildId`, `siteStrengthVersion` | string | Which graph release and scoring version the profile comes from. |
| `totalGraphReferringDomains` | integer | Every referring domain in the graph. |
| `scoreDistribution` | array | Ten ranges: `minSiteStrength`, `maxSiteStrength`, the `referringDomains` in that range and their `share` of the total (0–1). |
| `unscoredReferringDomains` | integer | Referring domains with no Site Strength. |
| `unscoredShare` | number | Their share of the total (0–1). |

The profile is a count, not a quality or spam verdict.

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

## MCP

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