Backlink History

DataForSEO

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

Capability: Backlink analysis
Current price: $0.0336/call
Availability: Ready to run

What this API does

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

Agents select this operation with tool ID dataforseo.backlink-history, then inspect its current executable contract before a run.

Public input and output shape

Input

date_fromstring · required

Value supplied for date from.

format: date

date_tostring · required

Value supplied for date to.

format: date

group_rangestring · optional

Value supplied for group range.

enum: day, week, month, year

include_subdomainsboolean · optional

Value supplied for include subdomains.

rank_scalestring · optional

Value supplied for rank scale.

enum: one_hundred, one_thousand

targetstring · required

Domain without protocol, path or www.

minLength: 1 · maxLength: 253

Output

itemsarray

Returned items value.

items_countnumber

Returned items count value.

targetstring

Returned target value.

Example request and output

This reviewed worked example is shared with inspect. Inspect also returns the current executable schema and price estimate before a paid run.

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
}

Teaching 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"}

Use Backlink History with Scrollport

Use Scrollport

Scrollport identifies and validates the best-in-class API tools and provides them on a pay-as-you-go basis so you don't need to maintain a separate provider account, subscription or credits.

Give your agent the setup prompt to receive $1 in trial credit and start using the tools right away.