{"openapi":"3.1.0","info":{"title":"Backlinks API - Referring Domains & Link Gap","version":"1.0.0","description":"The best-connected domains that link to any website, each with an authority score and Chrome popularity bucket, and a link-gap report: who links to up to 10 of your competitors but not to you. Built from the open Common Crawl domain-level web graph (updated quarterly): domain-level data for link prospecting, not individual backlink URLs or anchor texts.\n\nAll endpoints accept GET (query string) or POST (JSON body). Errors use one shape: `{\"success\": false, \"error\": {\"code\", \"message\", \"retryable\"}}`. When a numeric `Retry-After` header is present, `error.retryAfterSeconds` is included.","contact":{"name":"TidyTools","url":"https://apify.com/tidytools"}},"servers":[{"url":"https://webcapture-api.yukailin.workers.dev","description":"Origin (reachable only through the marketplace gateway)"}],"tags":[{"name":"Backlinks"}],"paths":{"/api/v1/referring-domains":{"get":{"operationId":"referringDomainsGet","summary":"Best-connected domains that link to a domain (GET)","description":"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.","tags":["Backlinks"],"parameters":[{"name":"domain","schema":{"type":"string"},"description":"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.","required":true,"example":"apify.com","in":"query"},{"name":"limit","schema":{"type":"integer","default":25,"minimum":1,"maximum":100},"description":"Referring domains returned.","required":false,"in":"query"},{"name":"minAuthority","schema":{"type":"integer","default":0,"minimum":0,"maximum":100},"description":"Only referring domains with at least this authority score.","required":false,"in":"query"},{"name":"onlyWithChromeTraffic","schema":{"type":"boolean","default":false},"description":"Only referring domains that are in the Chrome UX Report lists (they have real visitors).","required":false,"in":"query"},{"name":"excludeDomains","schema":{"type":"string"},"description":"Comma-separated domains to leave out (up to 200).","required":false,"in":"query"},{"name":"excludeBigPlatforms","schema":{"type":"boolean","default":false},"description":"Leave out big platforms where anyone can get a link (social networks, blog and site hosts, app stores, link shorteners, code hosts).","required":false,"in":"query"}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"const":true},"input":{"type":"string"},"domain":{"type":"string","description":"The domain that matched."},"totalReferringDomains":{"type":"integer","description":"All other domains that link to it in the Common Crawl web graph."},"listedReferringDomains":{"type":"integer","description":"Referring domains among the 5 million best-connected websites (the ones that can be listed)."},"listTruncated":{"type":"boolean","description":"true when more are listed than the dataset stores (only the best-connected `topK` are known)."},"matching":{"type":"integer","description":"Stored referring domains that pass your filters."},"count":{"type":"integer","description":"Rows in this answer."},"hasMore":{"type":"boolean","description":"More match than `limit`."},"filters":{"type":"object","description":"The filters applied, echoed back.","additionalProperties":true},"note":{"type":"string","description":"Only when no row passes the filters."},"referringDomains":{"type":"array","description":"Best-connected referring domains first.","items":{"type":"object","properties":{"position":{"type":"integer"},"referringDomain":{"type":"string"},"authorityScore":{"type":"integer","description":"0-100, the same score as the Domain Authority API."},"chromeTrafficBucket":{"type":"integer","nullable":true,"description":"Chrome UX Report popularity bucket of the referring domain (null when not listed)."},"trafficRank":{"type":"string","nullable":true,"description":"e.g. `Top 10K websites (Chrome)`."}}}},"dataset":{"type":"object","description":"Data release and sources (Common Crawl web graph, Chrome UX Report; keep the attribution when you publish the data).","properties":{"release":{"type":"string"},"builtAt":{"type":"string"},"sourceTop":{"type":"integer","description":"Only domains among the 5 million best-connected websites are listed as referring domains."},"topK":{"type":"integer","description":"At most this many referring domains are stored per domain (the best connected)."},"sources":{"type":"object","additionalProperties":true}}}}},"example":{"success":true,"input":"apify.com","domain":"apify.com","totalReferringDomains":3556,"listedReferringDomains":1527,"listTruncated":true,"matching":482,"count":8,"hasMore":true,"filters":{"minAuthority":50,"onlyWithChromeTraffic":false,"excludeBigPlatforms":true,"excludeDomains":0},"referringDomains":[{"position":1,"referringDomain":"europa.eu","authorityScore":88,"chromeTrafficBucket":50000,"trafficRank":"Top 50K websites (Chrome)"},{"position":2,"referringDomain":"nih.gov","authorityScore":85,"chromeTrafficBucket":5000,"trafficRank":"Top 5K websites (Chrome)"},{"position":3,"referringDomain":"arxiv.org","authorityScore":78,"chromeTrafficBucket":10000,"trafficRank":"Top 10K websites (Chrome)"},{"position":4,"referringDomain":"frontiersin.org","authorityScore":78,"chromeTrafficBucket":50000,"trafficRank":"Top 50K websites (Chrome)"}],"dataset":{"release":"cc-main-2026-jul-aug-sep","builtAt":"2026-10-03T13:44:07.544Z","sourceTop":5000000,"topK":1000,"sources":{"commonCrawl":{"release":"cc-main-2026-jul-aug-sep","url":"https://data.commoncrawl.org/projects/hyperlinkgraph/cc-main-2026-jul-aug-sep/index.html","terms":"https://commoncrawl.org/terms-of-use"},"crux":{"url":"https://raw.githubusercontent.com/zakird/crux-top-lists/main/data/global/current.csv.gz","license":"CC BY 4.0","note":"Chrome UX Report top origins (rank buckets), via zakird/crux-top-lists"}}}}}}},"400":{"description":"`invalid_request`: a parameter is missing, has the wrong type or is out of range (the message names it); a list that is too long; a string that is not a domain or website address.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"`domain_not_found`: no domain among the best-connected websites links to it in the Common Crawl web graph (or it was not crawled). Nothing is billed for a 404.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"success":false,"error":{"code":"domain_not_found","message":"No domain among the best-connected websites links to thisdomain-does-not-exist-xk29.com in the Common Crawl web graph (or it was not crawled).","details":{"domain":"thisdomain-does-not-exist-xk29.com"}}}}}},"413":{"description":"`too_large`: the request body is over 256 KB.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"`upstream_error`: a source could not be read right now (a dataset is not available, or every section of an overview failed). Safe to retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"referringDomains","summary":"Best-connected domains that link to a domain","description":"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.\n\nThe same parameters as the GET form, sent as a JSON body.","tags":["Backlinks"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string","description":"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":{"type":"integer","default":25,"minimum":1,"maximum":100,"description":"Referring domains returned."},"minAuthority":{"type":"integer","default":0,"minimum":0,"maximum":100,"description":"Only referring domains with at least this authority score."},"onlyWithChromeTraffic":{"type":"boolean","default":false,"description":"Only referring domains that are in the Chrome UX Report lists (they have real visitors)."},"excludeDomains":{"type":"string","description":"Comma-separated domains to leave out (up to 200)."},"excludeBigPlatforms":{"type":"boolean","default":false,"description":"Leave out big platforms where anyone can get a link (social networks, blog and site hosts, app stores, link shorteners, code hosts)."}},"required":["domain"]}}}},"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"const":true},"input":{"type":"string"},"domain":{"type":"string","description":"The domain that matched."},"totalReferringDomains":{"type":"integer","description":"All other domains that link to it in the Common Crawl web graph."},"listedReferringDomains":{"type":"integer","description":"Referring domains among the 5 million best-connected websites (the ones that can be listed)."},"listTruncated":{"type":"boolean","description":"true when more are listed than the dataset stores (only the best-connected `topK` are known)."},"matching":{"type":"integer","description":"Stored referring domains that pass your filters."},"count":{"type":"integer","description":"Rows in this answer."},"hasMore":{"type":"boolean","description":"More match than `limit`."},"filters":{"type":"object","description":"The filters applied, echoed back.","additionalProperties":true},"note":{"type":"string","description":"Only when no row passes the filters."},"referringDomains":{"type":"array","description":"Best-connected referring domains first.","items":{"type":"object","properties":{"position":{"type":"integer"},"referringDomain":{"type":"string"},"authorityScore":{"type":"integer","description":"0-100, the same score as the Domain Authority API."},"chromeTrafficBucket":{"type":"integer","nullable":true,"description":"Chrome UX Report popularity bucket of the referring domain (null when not listed)."},"trafficRank":{"type":"string","nullable":true,"description":"e.g. `Top 10K websites (Chrome)`."}}}},"dataset":{"type":"object","description":"Data release and sources (Common Crawl web graph, Chrome UX Report; keep the attribution when you publish the data).","properties":{"release":{"type":"string"},"builtAt":{"type":"string"},"sourceTop":{"type":"integer","description":"Only domains among the 5 million best-connected websites are listed as referring domains."},"topK":{"type":"integer","description":"At most this many referring domains are stored per domain (the best connected)."},"sources":{"type":"object","additionalProperties":true}}}}},"example":{"success":true,"input":"apify.com","domain":"apify.com","totalReferringDomains":3556,"listedReferringDomains":1527,"listTruncated":true,"matching":482,"count":8,"hasMore":true,"filters":{"minAuthority":50,"onlyWithChromeTraffic":false,"excludeBigPlatforms":true,"excludeDomains":0},"referringDomains":[{"position":1,"referringDomain":"europa.eu","authorityScore":88,"chromeTrafficBucket":50000,"trafficRank":"Top 50K websites (Chrome)"},{"position":2,"referringDomain":"nih.gov","authorityScore":85,"chromeTrafficBucket":5000,"trafficRank":"Top 5K websites (Chrome)"},{"position":3,"referringDomain":"arxiv.org","authorityScore":78,"chromeTrafficBucket":10000,"trafficRank":"Top 10K websites (Chrome)"},{"position":4,"referringDomain":"frontiersin.org","authorityScore":78,"chromeTrafficBucket":50000,"trafficRank":"Top 50K websites (Chrome)"}],"dataset":{"release":"cc-main-2026-jul-aug-sep","builtAt":"2026-10-03T13:44:07.544Z","sourceTop":5000000,"topK":1000,"sources":{"commonCrawl":{"release":"cc-main-2026-jul-aug-sep","url":"https://data.commoncrawl.org/projects/hyperlinkgraph/cc-main-2026-jul-aug-sep/index.html","terms":"https://commoncrawl.org/terms-of-use"},"crux":{"url":"https://raw.githubusercontent.com/zakird/crux-top-lists/main/data/global/current.csv.gz","license":"CC BY 4.0","note":"Chrome UX Report top origins (rank buckets), via zakird/crux-top-lists"}}}}}}},"400":{"description":"`invalid_request`: a parameter is missing, has the wrong type or is out of range (the message names it); a list that is too long; a string that is not a domain or website address.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"`domain_not_found`: no domain among the best-connected websites links to it in the Common Crawl web graph (or it was not crawled). Nothing is billed for a 404.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"success":false,"error":{"code":"domain_not_found","message":"No domain among the best-connected websites links to thisdomain-does-not-exist-xk29.com in the Common Crawl web graph (or it was not crawled).","details":{"domain":"thisdomain-does-not-exist-xk29.com"}}}}}},"413":{"description":"`too_large`: the request body is over 256 KB.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"`upstream_error`: a source could not be read right now (a dataset is not available, or every section of an overview failed). Safe to retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/link-gap":{"get":{"operationId":"linkGapGet","summary":"Link gap: domains that link to your competitors but not to you (GET)","description":"Link prospecting in one call: the domains that link to at least `minCompetitors` of up to 10 competitors but not to your domain, most-linked first, then highest authority, each with its authority score, Chrome popularity bucket and which competitors it links to. Big platforms (social networks, site builders, hosts, app stores) are left out by default. When your own referrer list is longer than the dataset stores, weaker prospects that might already link to you are flagged (`mayAlreadyLinkToYou`). Open data, updated quarterly.","tags":["Backlinks"],"parameters":[{"name":"yourDomain","schema":{"type":"string"},"description":"Your website: a domain or URL. Alias: `domain`.","required":true,"example":"apify.com","in":"query"},{"name":"competitors","schema":{"type":"array","items":{"type":"string"},"maxItems":10},"style":"form","explode":false,"required":true,"description":"Up to 10 competitor domains: a JSON array in the POST body, or comma- or space-separated in the query string (GET).","example":["scrapingbee.com","zenrows.com","brightdata.com"],"in":"query"},{"name":"limit","schema":{"type":"integer","default":25,"minimum":1,"maximum":100},"description":"Prospects returned.","required":false,"in":"query"},{"name":"minCompetitors","schema":{"type":"integer","default":1,"minimum":1,"maximum":10},"description":"Only domains that link to at least this many of your competitors.","required":false,"in":"query"},{"name":"minAuthority","schema":{"type":"integer","default":0,"minimum":0,"maximum":100},"description":"Only referring domains with at least this authority score.","required":false,"in":"query"},{"name":"onlyWithChromeTraffic","schema":{"type":"boolean","default":false},"description":"Only referring domains that are in the Chrome UX Report lists (they have real visitors).","required":false,"in":"query"},{"name":"excludeDomains","schema":{"type":"string"},"description":"Comma-separated domains to leave out (up to 200).","required":false,"in":"query"},{"name":"excludeBigPlatforms","schema":{"type":"boolean","default":true},"description":"Leave out big platforms where anyone can get a link (social networks, blog and site hosts, app stores, link shorteners, code hosts).","required":false,"in":"query"}],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"const":true},"yourDomain":{"type":"string"},"yourDomainFound":{"type":"boolean","description":"false when your domain is not in the dataset (no known referrers: every prospect then counts as a gap)."},"yourReferringDomains":{"type":"integer"},"yourListTruncated":{"type":"boolean"},"competitorsChecked":{"type":"integer","description":"Competitors compared (your own domain and duplicates are dropped)."},"prospectsMatching":{"type":"integer","description":"Prospects that pass your filters, before `limit`."},"count":{"type":"integer"},"hasMore":{"type":"boolean"},"filters":{"type":"object","description":"The filters applied, echoed back.","additionalProperties":true},"note":{"type":"string"},"competitors":{"type":"array","items":{"type":"object","properties":{"domain":{"type":"string"},"found":{"type":"boolean"},"referringDomains":{"type":"integer"},"listed":{"type":"integer"},"truncated":{"type":"boolean"}}}},"prospects":{"type":"array","description":"Most-linked first, then highest authority.","items":{"type":"object","properties":{"position":{"type":"integer"},"prospect":{"type":"string","description":"A domain that links to at least `minCompetitors` of your competitors but not (as far as the data shows) to you."},"authorityScore":{"type":"integer"},"chromeTrafficBucket":{"type":"integer","nullable":true},"trafficRank":{"type":"string","nullable":true},"linksToCompetitors":{"type":"array","items":{"type":"string"}},"competitorsLinked":{"type":"integer"},"competitorsChecked":{"type":"integer"},"linksToYou":{"type":"boolean","description":"Always false in this list."},"mayAlreadyLinkToYou":{"type":"boolean","description":"true when your own referrer list is cut at the stored top and this prospect is weaker than the weakest stored referrer of yours: it might already link to you."},"prospectUrl":{"type":"string"}}}},"dataset":{"type":"object","description":"Data release and sources (Common Crawl web graph, Chrome UX Report; keep the attribution when you publish the data).","properties":{"release":{"type":"string"},"builtAt":{"type":"string"},"sourceTop":{"type":"integer","description":"Only domains among the 5 million best-connected websites are listed as referring domains."},"topK":{"type":"integer","description":"At most this many referring domains are stored per domain (the best connected)."},"sources":{"type":"object","additionalProperties":true}}}}},"example":{"success":true,"yourDomain":"apify.com","yourDomainFound":true,"yourReferringDomains":3556,"yourListTruncated":true,"competitorsChecked":3,"prospectsMatching":516,"count":8,"hasMore":true,"filters":{"minCompetitors":1,"minAuthority":40,"onlyWithChromeTraffic":false,"excludeBigPlatforms":true,"excludeDomains":0},"competitors":[{"domain":"scrapingbee.com","found":true,"referringDomains":956,"listed":434,"truncated":false},{"domain":"zenrows.com","found":true,"referringDomains":637,"listed":386,"truncated":false},{"domain":"brightdata.com","found":true,"referringDomains":2158,"listed":869,"truncated":false}],"prospects":[{"position":1,"prospect":"companionlink.com","authorityScore":58,"chromeTrafficBucket":null,"trafficRank":null,"linksToCompetitors":["scrapingbee.com","zenrows.com","brightdata.com"],"competitorsLinked":3,"competitorsChecked":3,"linksToYou":false,"mayAlreadyLinkToYou":false,"prospectUrl":"https://companionlink.com/"},{"position":2,"prospect":"thedatascientist.com","authorityScore":51,"chromeTrafficBucket":null,"trafficRank":null,"linksToCompetitors":["scrapingbee.com","zenrows.com","brightdata.com"],"competitorsLinked":3,"competitorsChecked":3,"linksToYou":false,"mayAlreadyLinkToYou":false,"prospectUrl":"https://thedatascientist.com/"},{"position":3,"prospect":"latenode.com","authorityScore":44,"chromeTrafficBucket":null,"trafficRank":null,"linksToCompetitors":["scrapingbee.com","zenrows.com","brightdata.com"],"competitorsLinked":3,"competitorsChecked":3,"linksToYou":false,"mayAlreadyLinkToYou":false,"prospectUrl":"https://latenode.com/"},{"position":4,"prospect":"agilityportal.io","authorityScore":42,"chromeTrafficBucket":null,"trafficRank":null,"linksToCompetitors":["scrapingbee.com","zenrows.com","brightdata.com"],"competitorsLinked":3,"competitorsChecked":3,"linksToYou":false,"mayAlreadyLinkToYou":false,"prospectUrl":"https://agilityportal.io/"}],"dataset":{"release":"cc-main-2026-jul-aug-sep","builtAt":"2026-10-03T13:44:07.544Z","sourceTop":5000000,"topK":1000,"sources":{"commonCrawl":{"release":"cc-main-2026-jul-aug-sep","url":"https://data.commoncrawl.org/projects/hyperlinkgraph/cc-main-2026-jul-aug-sep/index.html","terms":"https://commoncrawl.org/terms-of-use"},"crux":{"url":"https://raw.githubusercontent.com/zakird/crux-top-lists/main/data/global/current.csv.gz","license":"CC BY 4.0","note":"Chrome UX Report top origins (rank buckets), via zakird/crux-top-lists"}}}}}}},"400":{"description":"`invalid_request`: a parameter is missing, has the wrong type or is out of range (the message names it); a list that is too long; a string that is not a domain or website address.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"`domain_not_found`: none of the competitors has referring domains in the dataset. Nothing is billed for a 404.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"success":false,"error":{"code":"domain_not_found","message":"No domain among the best-connected websites links to thisdomain-does-not-exist-xk29.com in the Common Crawl web graph (or it was not crawled).","details":{"domain":"thisdomain-does-not-exist-xk29.com"}}}}}},"413":{"description":"`too_large`: the request body is over 256 KB.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"`upstream_error`: a source could not be read right now (a dataset is not available, or every section of an overview failed). Safe to retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"linkGap","summary":"Link gap: domains that link to your competitors but not to you","description":"Link prospecting in one call: the domains that link to at least `minCompetitors` of up to 10 competitors but not to your domain, most-linked first, then highest authority, each with its authority score, Chrome popularity bucket and which competitors it links to. Big platforms (social networks, site builders, hosts, app stores) are left out by default. When your own referrer list is longer than the dataset stores, weaker prospects that might already link to you are flagged (`mayAlreadyLinkToYou`). Open data, updated quarterly.\n\nThe same parameters as the GET form, sent as a JSON body.","tags":["Backlinks"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"yourDomain":{"type":"string","description":"Your website: a domain or URL. Alias: `domain`."},"competitors":{"type":"array","items":{"type":"string"},"maxItems":10,"description":"Up to 10 competitor domains: a JSON array in the POST body, or comma- or space-separated in the query string (GET)."},"limit":{"type":"integer","default":25,"minimum":1,"maximum":100,"description":"Prospects returned."},"minCompetitors":{"type":"integer","default":1,"minimum":1,"maximum":10,"description":"Only domains that link to at least this many of your competitors."},"minAuthority":{"type":"integer","default":0,"minimum":0,"maximum":100,"description":"Only referring domains with at least this authority score."},"onlyWithChromeTraffic":{"type":"boolean","default":false,"description":"Only referring domains that are in the Chrome UX Report lists (they have real visitors)."},"excludeDomains":{"type":"string","description":"Comma-separated domains to leave out (up to 200)."},"excludeBigPlatforms":{"type":"boolean","default":true,"description":"Leave out big platforms where anyone can get a link (social networks, blog and site hosts, app stores, link shorteners, code hosts)."}},"required":["yourDomain","competitors"]}}}},"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"const":true},"yourDomain":{"type":"string"},"yourDomainFound":{"type":"boolean","description":"false when your domain is not in the dataset (no known referrers: every prospect then counts as a gap)."},"yourReferringDomains":{"type":"integer"},"yourListTruncated":{"type":"boolean"},"competitorsChecked":{"type":"integer","description":"Competitors compared (your own domain and duplicates are dropped)."},"prospectsMatching":{"type":"integer","description":"Prospects that pass your filters, before `limit`."},"count":{"type":"integer"},"hasMore":{"type":"boolean"},"filters":{"type":"object","description":"The filters applied, echoed back.","additionalProperties":true},"note":{"type":"string"},"competitors":{"type":"array","items":{"type":"object","properties":{"domain":{"type":"string"},"found":{"type":"boolean"},"referringDomains":{"type":"integer"},"listed":{"type":"integer"},"truncated":{"type":"boolean"}}}},"prospects":{"type":"array","description":"Most-linked first, then highest authority.","items":{"type":"object","properties":{"position":{"type":"integer"},"prospect":{"type":"string","description":"A domain that links to at least `minCompetitors` of your competitors but not (as far as the data shows) to you."},"authorityScore":{"type":"integer"},"chromeTrafficBucket":{"type":"integer","nullable":true},"trafficRank":{"type":"string","nullable":true},"linksToCompetitors":{"type":"array","items":{"type":"string"}},"competitorsLinked":{"type":"integer"},"competitorsChecked":{"type":"integer"},"linksToYou":{"type":"boolean","description":"Always false in this list."},"mayAlreadyLinkToYou":{"type":"boolean","description":"true when your own referrer list is cut at the stored top and this prospect is weaker than the weakest stored referrer of yours: it might already link to you."},"prospectUrl":{"type":"string"}}}},"dataset":{"type":"object","description":"Data release and sources (Common Crawl web graph, Chrome UX Report; keep the attribution when you publish the data).","properties":{"release":{"type":"string"},"builtAt":{"type":"string"},"sourceTop":{"type":"integer","description":"Only domains among the 5 million best-connected websites are listed as referring domains."},"topK":{"type":"integer","description":"At most this many referring domains are stored per domain (the best connected)."},"sources":{"type":"object","additionalProperties":true}}}}},"example":{"success":true,"yourDomain":"apify.com","yourDomainFound":true,"yourReferringDomains":3556,"yourListTruncated":true,"competitorsChecked":3,"prospectsMatching":516,"count":8,"hasMore":true,"filters":{"minCompetitors":1,"minAuthority":40,"onlyWithChromeTraffic":false,"excludeBigPlatforms":true,"excludeDomains":0},"competitors":[{"domain":"scrapingbee.com","found":true,"referringDomains":956,"listed":434,"truncated":false},{"domain":"zenrows.com","found":true,"referringDomains":637,"listed":386,"truncated":false},{"domain":"brightdata.com","found":true,"referringDomains":2158,"listed":869,"truncated":false}],"prospects":[{"position":1,"prospect":"companionlink.com","authorityScore":58,"chromeTrafficBucket":null,"trafficRank":null,"linksToCompetitors":["scrapingbee.com","zenrows.com","brightdata.com"],"competitorsLinked":3,"competitorsChecked":3,"linksToYou":false,"mayAlreadyLinkToYou":false,"prospectUrl":"https://companionlink.com/"},{"position":2,"prospect":"thedatascientist.com","authorityScore":51,"chromeTrafficBucket":null,"trafficRank":null,"linksToCompetitors":["scrapingbee.com","zenrows.com","brightdata.com"],"competitorsLinked":3,"competitorsChecked":3,"linksToYou":false,"mayAlreadyLinkToYou":false,"prospectUrl":"https://thedatascientist.com/"},{"position":3,"prospect":"latenode.com","authorityScore":44,"chromeTrafficBucket":null,"trafficRank":null,"linksToCompetitors":["scrapingbee.com","zenrows.com","brightdata.com"],"competitorsLinked":3,"competitorsChecked":3,"linksToYou":false,"mayAlreadyLinkToYou":false,"prospectUrl":"https://latenode.com/"},{"position":4,"prospect":"agilityportal.io","authorityScore":42,"chromeTrafficBucket":null,"trafficRank":null,"linksToCompetitors":["scrapingbee.com","zenrows.com","brightdata.com"],"competitorsLinked":3,"competitorsChecked":3,"linksToYou":false,"mayAlreadyLinkToYou":false,"prospectUrl":"https://agilityportal.io/"}],"dataset":{"release":"cc-main-2026-jul-aug-sep","builtAt":"2026-10-03T13:44:07.544Z","sourceTop":5000000,"topK":1000,"sources":{"commonCrawl":{"release":"cc-main-2026-jul-aug-sep","url":"https://data.commoncrawl.org/projects/hyperlinkgraph/cc-main-2026-jul-aug-sep/index.html","terms":"https://commoncrawl.org/terms-of-use"},"crux":{"url":"https://raw.githubusercontent.com/zakird/crux-top-lists/main/data/global/current.csv.gz","license":"CC BY 4.0","note":"Chrome UX Report top origins (rank buckets), via zakird/crux-top-lists"}}}}}}},"400":{"description":"`invalid_request`: a parameter is missing, has the wrong type or is out of range (the message names it); a list that is too long; a string that is not a domain or website address.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"`domain_not_found`: none of the competitors has referring domains in the dataset. Nothing is billed for a 404.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"success":false,"error":{"code":"domain_not_found","message":"No domain among the best-connected websites links to thisdomain-does-not-exist-xk29.com in the Common Crawl web graph (or it was not crawled).","details":{"domain":"thisdomain-does-not-exist-xk29.com"}}}}}},"413":{"description":"`too_large`: the request body is over 256 KB.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"`upstream_error`: a source could not be read right now (a dataset is not available, or every section of an overview failed). Safe to retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"Error":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","enum":["not_configured","unauthorized","not_found","method_not_allowed","invalid_request","rate_limited","url_not_allowed","target_blocked","target_unreachable","target_error","unsupported_content","too_large","timeout","upstream_error","board_not_found","app_not_found","robots_disallowed","browser_busy","region_unavailable","no_region_delivered","location_not_found","domain_not_found"]},"message":{"type":"string"},"retryable":{"type":"boolean","description":"true for rate_limited, timeout, upstream_error and browser_busy; false for other errors."},"retryAfterSeconds":{"type":"integer","description":"Seconds to wait before retrying, when a numeric Retry-After header is present."},"details":{"type":"object","additionalProperties":true}}}}}}}}