> ## Documentation Index
> Fetch the complete documentation index at: https://docs.markifact.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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...

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**:

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.