Get Backlinks History

Track how a domain’s backlink profile changed over time with DataForSEO, back to January 2019: monthly snapshots with links gained and lost, the same metrics grouped by day, week, month or year, or only the gains and losses per period. Needs the DataForSEO Backlinks subscription.


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

Inputs

Field	Type	Required	Default	Description
`target`	string	Yes	-	Domain to analyse, without the scheme or www (example.com). Pages are not supported by the history reports.
`report`	string or SelectableOption	No	`monthly`	’monthly’ (default): one row per month with the full profile snapshot plus the new and lost counts of that month. ‘period’: the same profile metrics grouped by day, week, month or year. ‘new_lost’: only the gained and lost backlinks and referring domains per period.
`date_from`	string	No	-	Start of the range in YYYY-MM-DD format, not earlier than 2019-01-01. Defaults to one year ago for monthly and to the whole history for the other reports.
`date_to`	string	No	-	End of the range in YYYY-MM-DD format. Defaults to today.
`group_range`	string or SelectableOption	No	`month`	period and new_lost reports: period length, one of day, week, month (default) or year.
`include_subdomains`	boolean	No	`True`	Count links to subdomains of the target as well. Defaults to true.
`rank_scale`	string or SelectableOption	No	`one_thousand`	Scale for the 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).
`fields`	string or array of string	No	-	Result columns to keep, e.g. date, rank, backlinks, new_backlinks, lost_backlinks, referring_domains, new_referring_domains, lost_referring_domains, referring_main_domains, referring_ips, broken_backlinks, crawled_pages. Leave empty for the default set listed in the output description.

SelectableOption

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

Output

Type: List[Dict] Returns one row per period, sorted by date. monthly: date, rank, backlinks, new_backlinks, lost_backlinks, referring_domains, new_referring_domains, lost_referring_domains, referring_main_domains, referring_ips, broken_backlinks, crawled_pages. period: date, rank, backlinks, backlinks_nofollow, referring_domains, referring_domains_nofollow, referring_main_domains, referring_pages, referring_ips, referring_subnets. new_lost: date, new_backlinks, lost_backlinks, new_referring_domains, lost_referring_domains, new_referring_main_domains, lost_referring_main_domains. Fields: date, rank, backlinks, referring_domains, new_backlinks, lost_backlinks Example:

[
  {
    "date": "2026-08-31 00:00:00 +00:00",
    "rank": 596,
    "backlinks": 7061158,
    "referring_domains": 58420,
    "new_backlinks": 41203,
    "lost_backlinks": 38112
  }
]

Get Started

Guides

Operations

Get Backlinks History

Inputs

SelectableOption

Output

​Inputs

​SelectableOption

​Output

Inputs

SelectableOption

Output