# Backlink History

DataForSEO

Track backlink and referring-domain growth or decline over time.

## Use this tool with your AI agent

1. Copy the prompt
2. Paste it into your agent
3. Tell it what you need

Read https://scrollport.com/start. Use my existing Scrollport connection, or help me connect if needed. Help me use Backlink History (tool ID: dataforseo.backlink-history). Ask me for the details you need, then show me the result.

**Already connected:** Your agent can use that connection.

**New user:** Your agent will guide you through setup, sign-in and authorisation.

Provider access is included.

Connect your first agent to receive $1 trial credit.

**Job:** [Check backlinks](https://scrollport.com/tools/backlink-api)

**Current price:** $0.0336/request

**Availability:** Ready to run

## Tool details

**About this tool**

Returns a daily, weekly, monthly or yearly backlink timeseries for link-velocity, campaign and loss monitoring.

**Inputs and outputs**

### Input

`date_from` string · required

Value supplied for date from.

format: date

`date_to` string · required

Value supplied for date to.

format: date

`group_range` string · optional

Value supplied for group range.

enum: day, week, month, year

`include_subdomains` boolean · optional

Value supplied for include subdomains.

`rank_scale` string · optional

Value supplied for rank scale.

enum: one_hundred, one_thousand

`target` string · required

Domain without protocol, path or www.

minLength: 1 · maxLength: 253

### Output

`items` array

Returned items value.

`items_count` number

Returned items count value.

`target` string

Returned target value.

**Example request and output**

Inspect returns this reviewed example, its estimated cost and the current input schema. Run calculates the estimate for your actual input.

### Request

```
{
  "tool_id": "dataforseo.backlink-history",
  "input": {
    "target": "dataforseo.com",
    "date_to": "2026-08-01",
    "date_from": "2026-07-01",
    "group_range": "week"
  }
}
```

### Output

```
{
  "items": [
    {
      "date": "2026-07-05 00:00:00 +00:00",
      "rank": 49,
      "backlinks": 347138,
      "referring_pages": 343231,
      "referring_domains": 3533
    }
  ],
  "target": "dataforseo.com",
  "items_count": 5
}
```

**Errors and limitations**

- `configuration_error`: DataForSEO account access, funding or cost controls blocked the request.Verify and fund the server-side DataForSEO API-access credentials, then retry unchanged.
- `invalid_input`: DataForSEO rejected a target, location or bounded result control.example: {"target":"dataforseo.com","date_from":"2026-07-01","date_to":"2026-08-01","group_range":"week"}

---

Canonical page: https://scrollport.com/tools/providers/dataforseo/backlink-history