Get Backlinks

List the individual backlinks pointing to a domain, subdomain or page from DataForSEO, with the linking URL and page title, anchor text, dofollow, source rank and spam score, and first and last seen dates. Filter to new, lost or broken links. Needs the DataForSEO Backlinks subscription.


App	DataForSEO
Operation ID	`dataforseo_get_backlinks`
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).
`mode`	string or SelectableOption	No	`as_is`	’as_is’ (default) returns every backlink, ‘one_per_domain’ one backlink per referring domain, ‘one_per_anchor’ one backlink per anchor text.
`filters`	array of FilterItem	No	-	Up to 8 filters on backlink fields, e.g. dofollow EQUALS true, domain_from_rank GREATER_THAN 500, is_new EQUALS true, anchor CONTAINS ‘seo tools’, backlink_spam_score LESS_THAN 30, page_from_language EQUALS en.
`orders`	array of OrderItem	No	-	Sort by up to 3 backlink fields, e.g. domain_from_rank DESC or first_seen DESC.
`limit`	integer	No	`100`	Maximum number of backlinks to return (1 to 1000). Defaults to 100.
`offset`	integer	No	-	Number of backlinks to skip, for paging.
`fields`	string or array of string	No	-	Result columns to keep, e.g. url_from, url_to, anchor, dofollow, domain_from_rank, page_from_rank, backlink_spam_score, first_seen, last_seen, is_new, is_lost, is_broken, tld_from, domain_from_country, page_from_title, text_pre, text_post, links_count, semantic_location. 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] Returns one row per backlink. Default columns: url_from, url_to, anchor, dofollow, domain_from_rank, page_from_rank, backlink_spam_score, tld_from, domain_from_country, page_from_title, links_count, is_new, is_lost, is_broken, first_seen, last_seen. Other columns available through fields include text_pre, text_post, semantic_location, attributes, item_type, page_from_language, page_from_size, page_from_external_links, url_to_status_code, url_to_spam_score, is_indirect_link and ranked_keywords_info. Fields: url_from, url_to, anchor, dofollow, domain_from_rank, backlink_spam_score, first_seen Example:

[
  {
    "url_from": "https://blog.example.com/seo-tools",
    "url_to": "https://ahrefs.com/",
    "anchor": "Ahrefs",
    "dofollow": true,
    "domain_from_rank": 412,
    "first_seen": "2024-03-11 08:12:04 +00:00"
  }
]

Get Started

Guides

Operations

Inputs

FilterItem

OrderItem

SelectableOption

Output

​Inputs

​FilterItem

​OrderItem

​SelectableOption

​Output

Inputs

FilterItem

OrderItem

SelectableOption

Output