Get Pages By Links

Rank the pages of a domain by inbound links from Ahrefs Site Explorer: by external backlinks and referring domains (with new and lost links over a period) or by internal links. Useful for finding link equity to redistribute and orphaned or broken linked pages.


App	Ahrefs
Operation ID	`ahrefs_get_pages_by_links`
Type	Action
Connection	`ahrefs` (required)
Credits per run	Free
Agent / MCP tool	Yes

Inputs

Field	Type	Required	Default	Description
`target`	string	Yes	-	The domain, subdomain or subfolder whose pages to rank by inbound links (e.g. example.com).
`mode`	string or SelectableOption	No	`subdomains`	How to interpret the target: ‘subdomains’ (domain and all subdomains, default), ‘domain’ (the exact host only), ‘prefix’ (every URL starting with the target), or ‘exact’ (the exact URL only).
`report`	string or SelectableOption	No	`backlinks`	’backlinks’ (default): pages ranked by external backlinks and referring domains. ‘internal_links’: pages ranked by internal links.
`history`	string or SelectableOption	No	`all_time`	Backlinks report only: ‘live’ counts only live links, ‘all_time’ also includes lost ones. Ignored when since_date is set.
`since_date`	string	No	-	Backlinks report only: include links lost since this date (YYYY-MM-DD). Overrides history.
`metrics`	array of string or SelectableOption	No	-	Fields to return (url_to is always included). Both reports: title_target, url_rating_target, links_to_target, dofollow_to_target, nofollow_to_target, redirects_to_target, first_seen_link, last_seen, last_visited_target, http_code_target, target_redirect, languages_target, powered_by_target. Backlinks report only: refdomains_target (5 units), top_domain_rating_source, new_links_to_target, lost_links_to_target, is_spam. Internal links report only: canonical_to_target. Defaults to title_target, url_rating_target, links_to_target, dofollow_to_target, refdomains_target (backlinks) or canonical_to_target (internal links), http_code_target.
`filters`	array of FilterItem	No	-	Filters on the report’s fields, e.g. links_to_target GREATER_THAN 10 or url_to CONTAINS ‘/blog/’.
`orders`	array of OrderItem	No	-	Sort by one field (http_code_target, languages_target, last_visited_target, powered_by_target, target_redirect and title_target are not sortable).
`limit`	integer	No	`100`	Maximum number of pages to return. Defaults to 100. Your Ahrefs plan caps rows per request (Lite 100, Standard 250, Advanced 500).

Field	Type	Required	Default	Description
`field`	string or SelectableOption	Yes	-	The field to filter on, must be one of the current selected metrics or dimensions.
`operator`	string	Yes	-	The operator to use for filtering. Must be one of the supported values. Use REGEXP_MATCH to search/filter by multiple OR values like ’.(summer\|holiday).’
`value`	string	Yes	-	The value to filter by, always as a string: text, a number, or a regex. For IN_LIST and NOT_IN_LIST, pass the values as one comma-separated string such as ‘a,b,c’, not as an array.

OrderItem

Field	Type	Required	Default	Description
`field`	string or SelectableOption	Yes	-	The field to sort by. must be one of the current selected metrics or dimensions.
`direction`	string	Yes	-	The order to sort by, must be one of ‘ASC’, ‘DESC’

SelectableOption

Field	Type	Required	Default	Description
`value`	string	Yes	-
`label`	string	Yes	-

Output

Type: List[Dict] Returns one row per page: url_to plus the selected fields such as title_target, url_rating_target, links_to_target, dofollow_to_target, nofollow_to_target, redirects_to_target, refdomains_target, top_domain_rating_source, new_links_to_target, lost_links_to_target, canonical_to_target (internal links), http_code_target, target_redirect, first_seen_link, last_seen, is_spam. Fields: url_to, title_target, url_rating_target, links_to_target, dofollow_to_target, refdomains_target, http_code_target Example:

[
  {
    "url_to": "https://ahrefs.com/backlink-checker",
    "title_target": "Free Backlink Checker by Ahrefs",
    "url_rating_target": 27.0,
    "links_to_target": 812345,
    "dofollow_to_target": 640120,
    "refdomains_target": 4887,
    "http_code_target": 200
  }
]

Get Started

Guides

Operations

Get Pages By Links

Inputs

FilterItem

OrderItem

SelectableOption

Output

​Inputs

​FilterItem

​OrderItem

​SelectableOption

​Output

Inputs

FilterItem

OrderItem

SelectableOption

Output