All Referring Domains API

Lists every domain that links to a domain in the Rankfield web graph, with its Site Strength, 1,000 a page. Filter by Site Strength, sort either way, or export the whole list as CSV or JSONL.

Need only the count? Referring Domains is one call. Need the spread by strength? Referrer Profile.

GEThttps://rankfield.dev/v1/domains/{domain}/referrers

Send Authorization: Bearer YOUR_API_KEY. Get a free key; no account needed.

curl "https://rankfield.dev/v1/domains/github.com/referrers?limit=3" \
  -H "Authorization: Bearer $RANKFIELD_API_KEY"

import os
import requests

response = requests.get(
    "https://rankfield.dev/v1/domains/github.com/referrers?limit=3",
    headers={"Authorization": f"Bearer {os.environ['RANKFIELD_API_KEY']}"},
)
print(response.json())

const response = await fetch("https://rankfield.dev/v1/domains/github.com/referrers?limit=3", {
  headers: {
    Authorization: `Bearer ${process.env.RANKFIELD_API_KEY}`,
  },
});
console.log(await response.json());

Response

{
  "domain": "github.com",
  "crawlRelease": "2026-may-jun-jul",
  "buildId": "graph-2026mayjunjul-v3",
  "asOf": "2026-08-19T00:00:00Z",
  "totalGraphRelationships": 748920,
  "sort": "strength_desc",
  "minSiteStrength": 0,
  "referrers": [
    { "domain": "adobe.com", "siteStrength": 100 },
    { "domain": "amazon.com", "siteStrength": 100 },
    { "domain": "amazonaws.com", "siteStrength": 100 }
  ],
  "nextCursor": "eyJ2IjoxLCJkb21haW4iOiJnaXRodWIuY29tIi…"
}

Parameters#

Name	Type	Description
`domain`path, required	string	A domain such as `github.com`. Case and a leading `www.` are ignored; a URL works too, URL-encoded.
`limit`query, optional	integerdefault `100`	Domains per page, 1 to 1,000.
`cursor`query, optional	string	`nextCursor` from the previous page. It keeps the filters, the order and the graph release of the first page.
`minSiteStrength`query, optional	integerdefault `0`	Leave out domains below this Site Strength, 0 to 100.
`sort`query, optional	stringdefault `strength_desc`	`strength_desc` or `strength_asc`.
`format`query, optional	stringdefault `json`	`csv` or `jsonl` export every matching row instead of one page (see Export).

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` `buildId` `asOf`	string	The web graph release, its build and the date the data describes.
`totalGraphRelationships`	integer	How many referring domains the domain has in the graph: all pages put together.
`sort` `minSiteStrength`	string, integer	The order and filter this page uses.
`referrers`	array	`{domain, siteStrength}`, strongest first by default. `siteStrength` is `null` for a domain without enough rank evidence.
`nextCursor`	string \| null	Pass it as `cursor` for the next page; `null` on the last page.

Errors#

Errors come as {"error":{"message":"…"}} with the HTTP status.

Status	When
`400`	The domain is not valid: `{"error":{"message":"Invalid domain"}}`.
`401`	The key is missing, unknown or revoked.
`409`	An export is already running for your key.
`429`	Only while the graph service is down and its fallback is busy. Wait for `Retry-After`.
`503`	The graph is briefly unavailable. Retry after `Retry-After`.

Price and limits#

Free; no per-call charge.
No daily quota or concurrency cap per key.

Export the whole list#

Add format=csv or format=jsonl to export every referring domain that matches minSiteStrength, with no page limit. Rows: domain, siteStrength, crawlRelease, asOf, evidenceCoverage.

Up to 50,000 rows stream straight back. A longer list answers 202 with a job: follow statusUrl (GET /v1/jobs/{id}) until status is completed, then download GET /v1/jobs/{id}/download, or the checksummed parts at /v1/jobs/{id}/parts/{index} (10,000 rows each). DELETE /v1/jobs/{id} cancels; POST /v1/jobs/{id}/resume restarts a failed job. Files are kept for 7 days.

One export runs at a time per key; a second one answers 409. A real run: example.com's 150,374 referring domains were ready in 1.4 seconds as an 11.8 MB CSV.

Reference: https://rankfield.dev/docs/referring-domains/start-an-export-job

curl "https://rankfield.dev/v1/domains/example.com/referrers?format=csv" \
  -H "Authorization: Bearer $RANKFIELD_API_KEY"

import os
import requests

response = requests.get(
    "https://rankfield.dev/v1/domains/example.com/referrers?format=csv",
    headers={"Authorization": f"Bearer {os.environ['RANKFIELD_API_KEY']}"},
)
print(response.json())

const response = await fetch("https://rankfield.dev/v1/domains/example.com/referrers?format=csv", {
  headers: {
    Authorization: `Bearer ${process.env.RANKFIELD_API_KEY}`,
  },
});
console.log(await response.json());