--- title: "Referring domains" method: POST path: "/competitive-analysis/link-intersect-refdomains" tags: ["Competitive Analysis"] --- # Referring domains `POST /competitive-analysis/link-intersect-refdomains` ## Request - Base URL: `https://api.ahrefs.com/v3` - URL: `https://api.ahrefs.com/v3/competitive-analysis/link-intersect-refdomains` - Auth: HTTP bearer ## Request body - object - `select` string[], required: A list of columns to return. See response schema for valid column identifiers. - `where` object: The filter expression. The following column identifiers are recognized (this differs from the identifiers recognized by the `select` parameter). **anchor**: The clickable words in a link that point to a URL. type: string **domain**: The referring domain. type: string **domain_rating**: The Domain Rating of the referring domain. type: float **intersect**: Number of competitors linked from this result. type: integer **is_content**: The link was found in the biggest piece of content on the page. type: boolean **is_dofollow**: The link has no special nofollow attribute. type: boolean **is_homepage_link**: The link was found on the homepage of a referring website. type: boolean **is_nofollow**: The link or the referring page has the nofollow attribute set. type: boolean **is_root_domain**: The referring domain name is a root domain name. type: boolean **is_sponsored**: The link has the Sponsored attribute set in the referring page HTML. type: boolean **is_ugc**: The link has the User Generated Content attribute set in the referring page HTML. type: boolean **languages**: The languages listed in the referring page metadata or detected by the crawler to appear in the HTML. type: array(string) **link_type**: The kind of the backlink. type: string enum: `"redirect"` `"frame"` `"text"` `"form"` `"canonical"` `"alternate"` `"rss"` `"image"` **linked_domains**: The number of unique root domains linked from the referring page. type: integer **links_external**: The number of external links from the referring page. type: integer **links_to_competitor_1**: Number of links from the referring domain to competitor 1. type: integer **links_to_competitor_2**: Number of links from the referring domain to competitor 2. type: integer **links_to_competitor_3**: Number of links from the referring domain to competitor 3. type: integer **links_to_competitor_4**: Number of links from the referring domain to competitor 4. type: integer **links_to_competitor_5**: Number of links from the referring domain to competitor 5. type: integer **links_to_competitor_6**: Number of links from the referring domain to competitor 6. type: integer **links_to_competitor_7**: Number of links from the referring domain to competitor 7. type: integer **links_to_competitor_8**: Number of links from the referring domain to competitor 8. type: integer **links_to_competitor_9**: Number of links from the referring domain to competitor 9. type: integer **links_to_competitor_10**: Number of links from the referring domain to competitor 10. type: integer **links_to_competitor_11**: Number of links from the referring domain to competitor 11. type: integer **links_to_competitor_12**: Number of links from the referring domain to competitor 12. type: integer **links_to_competitor_13**: Number of links from the referring domain to competitor 13. type: integer **links_to_competitor_14**: Number of links from the referring domain to competitor 14. type: integer **links_to_competitor_15**: Number of links from the referring domain to competitor 15. type: integer **links_to_competitor_16**: Number of links from the referring domain to competitor 16. type: integer **links_to_competitor_17**: Number of links from the referring domain to competitor 17. type: integer **links_to_competitor_18**: Number of links from the referring domain to competitor 18. type: integer **links_to_competitor_19**: Number of links from the referring domain to competitor 19. type: integer **links_to_competitor_20**: Number of links from the referring domain to competitor 20. type: integer **links_to_target**: Number of links from the referring domain to the target. type: integer **page_category**: Comma-separated list of AI-predicted hierarchical category paths for the referring page. Each value is a slash-prefixed path (e.g. /Business_and_Industrial/Advertising_and_Marketing/Marketing). See [Page type and category classifications](https://docs.ahrefs.com/api/docs/page-classifications) for the taxonomy and filtering examples. type: string nullable **page_type**: Comma-separated list of AI-predicted hierarchical page type paths for the referring page. Each value is a slash-prefixed path (e.g. /Article/How_to). See [Page type and category classifications](https://docs.ahrefs.com/api/docs/page-classifications) for the taxonomy and filtering examples. type: string nullable **positions**: The number of keywords that the referring page ranks for in the top 100 positions. type: integer **powered_by**: Web technologies used to build and serve the referring page content. type: array(string) **refdomains** (5 units): The number of unique referring domains linking to the referring page. type: integer **snippet_left**: The snippet of text appearing just before the link. type: string **snippet_right**: The snippet of text appearing just after the link. type: string **source_page_author**: The author of the referring page. type: string nullable **title**: The html title of the referring page. type: string **traffic_domain** (10 units): The estimated monthly organic traffic of the referring domain. type: integer **traffic_page** (10 units): The referring page's estimated monthly organic traffic from search. type: integer **url_from**: The URL of the page containing a link to your target. type: string - `order_by` string[]: A list of columns to order results by, with optional direction. See response schema for valid column identifiers. - `limit` integer: The number of results to return. - `timeout` integer: A manual timeout duration in seconds. - `target` object, required: The target to compare. - `url` string, url, required: The target domain or URL. - `mode` 'exact' | 'prefix' | 'domain' | 'subdomains', required: The scope of the target. - `protocol` 'both' | 'http' | 'https', required: The target protocol. - `competitors` object[], required: The competitors whose backlinks are compared with the target, in output column order. - `url` string, url, required: The target domain or URL. - `mode` 'exact' | 'prefix' | 'domain' | 'subdomains', required: The scope of the target. - `protocol` 'both' | 'http' | 'https', required: The target protocol. - `output` 'json' | 'csv' | 'xml' | 'php': The output format. ## Response `200` OK - CompetitiveAnalysisLinkIntersectRefdomains - `referring-domains` object[] - `domain` string: The referring domain. - `domain_rating` number, float: The Domain Rating of the referring domain. - `intersect` integer: Number of competitors linked from this result. - `links_to_competitor_1` integer: Number of links from the referring domain to competitor 1. - `links_to_competitor_2` integer: Number of links from the referring domain to competitor 2. - `links_to_competitor_3` integer: Number of links from the referring domain to competitor 3. - `links_to_competitor_4` integer: Number of links from the referring domain to competitor 4. - `links_to_competitor_5` integer: Number of links from the referring domain to competitor 5. - `links_to_competitor_6` integer: Number of links from the referring domain to competitor 6. - `links_to_competitor_7` integer: Number of links from the referring domain to competitor 7. - `links_to_competitor_8` integer: Number of links from the referring domain to competitor 8. - `links_to_competitor_9` integer: Number of links from the referring domain to competitor 9. - `links_to_competitor_10` integer: Number of links from the referring domain to competitor 10. - `links_to_competitor_11` integer: Number of links from the referring domain to competitor 11. - `links_to_competitor_12` integer: Number of links from the referring domain to competitor 12. - `links_to_competitor_13` integer: Number of links from the referring domain to competitor 13. - `links_to_competitor_14` integer: Number of links from the referring domain to competitor 14. - `links_to_competitor_15` integer: Number of links from the referring domain to competitor 15. - `links_to_competitor_16` integer: Number of links from the referring domain to competitor 16. - `links_to_competitor_17` integer: Number of links from the referring domain to competitor 17. - `links_to_competitor_18` integer: Number of links from the referring domain to competitor 18. - `links_to_competitor_19` integer: Number of links from the referring domain to competitor 19. - `links_to_competitor_20` integer: Number of links from the referring domain to competitor 20. - `links_to_target` integer: Number of links from the referring domain to the target. - `traffic_domain` integer: (10 units) The estimated monthly organic traffic of the referring domain. ## Other responses - `400`: Bad Request - `401`: Unauthorized - `403`: Forbidden - `429`: Too Many Requests - `500`: Internal Error ## Changes - **2026-10-08** `8119c7cf1448`: 1 info - endpoint added [Operation history](https://skmtc.dev/ahrefs/apis/ahrefs-api/changes/competitive-analysis/link-intersect-refdomains/post.md) --- [API](https://skmtc.dev/ahrefs/apis/ahrefs-api.md) - [All operations](https://skmtc.dev/ahrefs/apis/ahrefs-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ahrefs/apis/ahrefs-api/revisions/667fedfff126?raw)