Referring domains

POST https://tools.yukai.uk/api/v1/referring-domains

Best-connected domains that link to a domain. The best-connected referring domains of one domain from the Common Crawl domain-level web graph: each with its 0-100 authority score and Chrome popularity bucket, best first, plus the total number of referring domains. Only domains among the 5 million best-connected websites can be listed (and at most the best 1,000 per domain are stored), which is what a link builder wants; totalReferringDomains counts all of them. Open data, updated quarterly; this is a domain-level graph, not a list of individual backlink URLs or anchor texts.

Cost

Credits: 14 per referring domain ($0.0014 per referring domain). 280 credits are reserved before the call; the call is then settled on the real number of items returned. Failed calls are free. Source price: backlink-gap/referring-domain.

Input

Send a JSON body (POST) or the same fields as a query string (GET).

Required: domain.

Field	Type	Default	Description
`domain` required	string		A domain or website address: `stripe.com`, `https://www.stripe.com/pricing`, `shop.example.co.uk` (the parent domain is used when the exact name is not in the dataset, unless `exact=true`). Alias: `url`. One domain per call.
`limit`	integer	`25`	Referring domains returned.
`minAuthority`	integer	`0`	Only referring domains with at least this authority score.
`onlyWithChromeTraffic`	boolean	`false`	Only referring domains that are in the Chrome UX Report lists (they have real visitors).
`excludeDomains`	string		Comma-separated domains to leave out (up to 200).
`excludeBigPlatforms`	boolean	`false`	Leave out big platforms where anyone can get a link (social networks, blog and site hosts, app stores, link shorteners, code hosts).

Examples

Replace tt_live_XXXX with your key from the pricing page.

curl

curl -i -X POST "https://tools.yukai.uk/api/v1/referring-domains" \
  -H "Authorization: Bearer tt_live_XXXX" \
  -H "Content-Type: application/json" \
  -d '{"domain":"apify.com"}'

JavaScript (fetch)

const res = await fetch("https://tools.yukai.uk/api/v1/referring-domains", {
  method: "POST",
  headers: { "Authorization": "Bearer tt_live_XXXX", "Content-Type": "application/json" },
  body: JSON.stringify({"domain":"apify.com"}),
});
console.log(res.status, res.headers.get("x-credits-charged"), res.headers.get("x-credits-balance"));
console.log(await res.json());

Python (requests)

import requests

r = requests.post(
    "https://tools.yukai.uk/api/v1/referring-domains",
    headers={"Authorization": "Bearer tt_live_XXXX"},
    json={"domain": "apify.com"},
    timeout=120,
)
print(r.status_code, r.headers.get("x-credits-charged"), r.headers.get("x-credits-balance"))
print(r.json())

Response

JSON with "success": true and the result fields; on failure {"success": false, "error": {"code", "message", "retryable"}} and no credits are used. Every answer carries x-credits-charged (credits used) and x-credits-balance (balance after the call); check the balance any time with GET https://tools.yukai.uk/v1/billing/balance.

Full field list and response schema: OpenAPI spec backlinks (its servers entry is the marketplace gateway; call https://tools.yukai.uk with your key).

← All routes · Pricing