Referring pages

API + MCPEnterprise Only

POST/v3/competitive-analysis/link-intersect-refpages

Request body

selectarray<string>Required

A list of columns to return. See response schema for valid column identifiers.

Example:["field_a","field_b"]

whereobject

The filter expression. The following column identifiers are recognized (this differs from the identifiers recognized by the select parameter).

order_byarray<string>

A list of columns to order results by, with optional direction. See response schema for valid column identifiers.

Example:["field_a","field_b:asc","field_c:desc"]

limitinteger

The number of results to return.

Default:1000

timeoutinteger

A manual timeout duration in seconds.

targetobjectRequired

The target to compare.

urlstring (url)required

The target domain or URL.

modestringrequired

The scope of the target.

Allowed values:exactprefixdomainsubdomains

protocolstringrequired

The target protocol.

Allowed values:bothhttphttps

competitorsarray<object>Required

The competitors whose backlinks are compared with the target, in output column order.

Min:1Max:20

urlstring (url)required

The target domain or URL.

modestringrequired

The scope of the target.

Allowed values:exactprefixdomainsubdomains

protocolstringrequired

The target protocol.

Allowed values:bothhttphttps

outputstring

The output format.

Allowed values:jsoncsvxmlphp

Responses

referring-pagesarray<object>

domain_ratingnumber (float)

The Domain Rating of the referring page's domain.

intersectinteger

Number of competitors linked from this result.

links_to_competitor_1integer

Number of links from the referring page to competitor 1.

links_to_competitor_2integer

Number of links from the referring page to competitor 2.

links_to_competitor_3integer

Number of links from the referring page to competitor 3.

links_to_competitor_4integer

Number of links from the referring page to competitor 4.

links_to_competitor_5integer

Number of links from the referring page to competitor 5.

links_to_competitor_6integer

Number of links from the referring page to competitor 6.

links_to_competitor_7integer

Number of links from the referring page to competitor 7.

links_to_competitor_8integer

Number of links from the referring page to competitor 8.

links_to_competitor_9integer

Number of links from the referring page to competitor 9.

links_to_competitor_10integer

Number of links from the referring page to competitor 10.

links_to_competitor_11integer

Number of links from the referring page to competitor 11.

links_to_competitor_12integer

Number of links from the referring page to competitor 12.

links_to_competitor_13integer

Number of links from the referring page to competitor 13.

links_to_competitor_14integer

Number of links from the referring page to competitor 14.

links_to_competitor_15integer

Number of links from the referring page to competitor 15.

links_to_competitor_16integer

Number of links from the referring page to competitor 16.

links_to_competitor_17integer

Number of links from the referring page to competitor 17.

links_to_competitor_18integer

Number of links from the referring page to competitor 18.

links_to_competitor_19integer

Number of links from the referring page to competitor 19.

links_to_competitor_20integer

Number of links from the referring page to competitor 20.

links_to_targetinteger

Number of links from the referring page to the target.

refdomainsinteger

(5 units) The number of domains linking to the referring page.

titlestring

The referring page title.

traffic_domaininteger

(10 units) The estimated monthly organic traffic of the referring page's domain.

traffic_pageinteger

(10 units) The estimated monthly organic traffic of the referring page.

urlstring (url)

The referring page URL.

url_ratingnumber (float)

The URL Rating of the referring page.

curl "https://api.ahrefs.com/v3/competitive-analysis/link-intersect-refpages" \ -X POST \ -H "Authorization: Bearer $AHREFS_API_KEY" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ --data-raw '{ "select": ["field_a","field_b"], "where": {}, "order_by": ["field_a","field_b:asc","field_c:desc"], "limit": 0, "timeout": 0, "target": { "url": "string", "mode": "exact", "protocol": "both" }, "competitors": [ { "url": "string", "mode": "exact", "protocol": "both" } ], "output": "json" }'

{ "referring-pages": [ { "domain_rating": 0.0, "intersect": 0, "links_to_competitor_1": 0, "links_to_competitor_2": 0, "links_to_competitor_3": 0, "links_to_competitor_4": 0, "links_to_competitor_5": 0, "links_to_competitor_6": 0, "links_to_competitor_7": 0, "links_to_competitor_8": 0, "links_to_competitor_9": 0, "links_to_competitor_10": 0, "links_to_competitor_11": 0, "links_to_competitor_12": 0, "links_to_competitor_13": 0, "links_to_competitor_14": 0, "links_to_competitor_15": 0, "links_to_competitor_16": 0, "links_to_competitor_17": 0, "links_to_competitor_18": 0, "links_to_competitor_19": 0, "links_to_competitor_20": 0, "links_to_target": 0, "refdomains": 0, "title": "string", "traffic_domain": 0, "traffic_page": 0, "url": "string", "url_rating": 0.0 } ] }