Get Referrer Profile

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

GEThttps://rankfield.dev/v1/domains/{domain}/referrer-profile

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

import requests

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

const response = await fetch("https://rankfield.dev/v1/domains/wikipedia.org/referrer-profile", {
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
  },
});
console.log(await response.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.

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, the tool for this is get_referrer_profile.

Get Referrer Profile

#Parameters

#Headers

#Path parameters

#Response

#Errors

#Limits

#MCP