> ## 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 Bulk Backlink Metrics

> Score up to 1000 domains, subdomains or pages in one DataForSEO request: backlink counts, referring domains, links gained and lost since a date, rank, spam score, or the full profile per target

Score up to 1000 domains, subdomains or pages in one DataForSEO request: backlink counts, referring domains, links gained and lost since a date, rank, spam score, or the full profile per target. Built for qualifying prospect lists or tracking a portfolio cheaply. Needs the DataForSEO Backlinks subscription.

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

## Inputs

| Field | Type | Required | Default | Description |
| - | - | - | - | - |
| `targets` | array of string or string | Yes | - | Up to 1000 domains, subdomains or pages, as a list or newline/comma-separated text. Domains go in bare (example.com); pages need their full URL. One request covers the whole list, which makes this the cheap way to score a large prospect or client list. |
| `metric` | string or SelectableOption | No | `backlinks` | Which metric to pull for every target: 'backlinks' (default, backlink count), 'referring\_domains' (referring and main referring domains, with the nofollow split), 'new\_lost\_backlinks' or 'new\_lost\_referring\_domains' (gained and lost since a date), 'ranks' (DataForSEO rank), 'spam\_score', or 'pages\_summary' (the full profile per target: backlinks, referring domains, IPs, broken links, spam score). |
| `date_from` | string | No | - | new\_lost metrics only: the date from which links count as new or lost, in YYYY-MM-DD format, not earlier than 2019-01-01. Defaults to one month ago. |
| `include_subdomains` | boolean | No | `True` | Count links to subdomains of each 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 | - | pages\_summary only: result columns to keep, e.g. url, rank, main\_domain\_rank, backlinks, referring\_domains, referring\_main\_domains, referring\_ips, broken\_backlinks, backlinks\_spam\_score, first\_seen, lost\_date. 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 target. backlinks: target, backlinks. referring\_domains: target, referring\_domains, referring\_domains\_nofollow, referring\_main\_domains, referring\_main\_domains\_nofollow. new\_lost\_backlinks: target, new\_backlinks, lost\_backlinks. new\_lost\_referring\_domains: target, new\_referring\_domains, lost\_referring\_domains, new\_referring\_main\_domains, lost\_referring\_main\_domains. ranks: target, rank. spam\_score: target, spam\_score. pages\_summary: url, rank, main\_domain\_rank, backlinks, referring\_domains, referring\_main\_domains, referring\_ips, referring\_pages, broken\_backlinks, broken\_pages, backlinks\_spam\_score, first\_seen, lost\_date.

**Fields**: `target`, `backlinks`

**Example**:

```json theme={"dark"}
[
  {
    "target": "ahrefs.com",
    "backlinks": 7061158
  },
  {
    "target": "semrush.com",
    "backlinks": 31240980
  }
]
```


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