Get Backlink Pages

Find which pages of a site attract its backlinks, from DataForSEO: backlinks, referring domains, rank and spam score per page, optionally with the crawled on-page data (status code, title, headings, word count, technologies). Needs the DataForSEO Backlinks subscription.


App	DataForSEO
Operation ID	`dataforseo_get_backlink_pages`
Type	Action
Connection	`dataforseo` (required)
Credits per run	Free
Agent / MCP tool	Yes

Inputs

Field	Type	Required	Default	Description
`target`	string	Yes	-	Domain, subdomain or page to analyse. Domains go in bare (example.com, blog.example.com); a single page needs its full URL (`https://example.com/pricing`).
`include_subdomains`	boolean	No	`True`	Count links to subdomains of the target as well. Defaults to true.
`exclude_internal_backlinks`	boolean	No	`True`	Leave out links coming from the target’s own subdomains. Defaults to true.
`backlinks_status_type`	string or SelectableOption	No	`live`	Which backlinks to count: ‘live’ (default, found on the last crawl), ‘all’ (live and lost together) or ‘lost’ (only links that disappeared).
`rank_scale`	string or SelectableOption	No	`one_thousand`	Scale for the rank, domain_from_rank and page_from_rank values: ‘one_thousand’ (DataForSEO’s default, 0 to 1000) or ‘one_hundred’ (0 to 100, comparable to the domain ratings other SEO tools show).
`report`	string or SelectableOption	No	`summary`	’summary’ (default): one row per page of the target with its backlink counts, the fastest way to find the most linked pages. ‘pages’: the same pages with the crawled on-page data as well (title, headings, word count, technologies, spam score).
`top_n`	integer	No	`5`	summary only: how many entries to keep in each distribution per row (top TLDs, countries, link types), 1 to 10. Defaults to 5.
`filters`	array of FilterItem	No	-	Up to 8 filters. summary: url, backlinks, referring_domains, rank, backlinks_spam_score, broken_backlinks. pages: page, status_code, meta.title, meta.words_count, meta.page_spam_score, page_summary.backlinks, page_summary.referring_domains.
`orders`	array of OrderItem	No	-	Sort by up to 3 result fields, e.g. backlinks DESC (summary) or page_summary.backlinks DESC (pages).
`limit`	integer	No	`100`	Maximum number of pages to return (1 to 1000). Defaults to 100.
`offset`	integer	No	-	Number of rows to skip, for paging.
`fields`	string or array of string	No	-	Result columns to keep. summary: url, backlinks, referring_domains, rank, backlinks_spam_score, broken_backlinks, first_seen, lost_date. pages: page, status_code, meta.title, meta.h1, meta.words_count, meta.internal_links_count, meta.external_links_count, meta.page_spam_score, page_summary.backlinks, page_summary.referring_domains, page_summary.rank. Leave empty for the default set listed in the output description.

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. For regex values, escape backslashes once in the JSON string: write \b for a word boundary, not \b.

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] summary: one row per page with url, rank, backlinks, referring_domains, referring_pages, referring_ips, backlinks_spam_score, broken_backlinks, referring_links_types, first_seen, lost_date. pages: page, status_code, meta.title, meta.h1, meta.words_count, meta.internal_links_count, meta.external_links_count, meta.page_spam_score, page_summary.rank, page_summary.backlinks, page_summary.referring_domains, page_summary.broken_backlinks, fetch_time, with meta.h2, meta.h3, meta.canonical, meta.language, meta.technologies, meta.social_media_tags and the rest of page_summary available through fields. Fields: url, rank, backlinks, referring_domains, backlinks_spam_score Example:

[
  {
    "url": "https://ahrefs.com/blog/",
    "rank": 512,
    "backlinks": 84200,
    "referring_domains": 9120,
    "backlinks_spam_score": 11
  }
]

Get Started

Guides

Operations

Get Backlink Pages

Inputs

FilterItem

OrderItem

SelectableOption

Output

​Inputs

​FilterItem

​OrderItem

​SelectableOption

​Output

Inputs

FilterItem

OrderItem

SelectableOption

Output