> ## 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
  }
]
```