Backlink History

Monthly history of a target's backlink profile — totals plus new and lost backlinks and referring domains for each month.

POST/v1/seo/backlinks/history

$0.05/call

One row per month: the size of the backlink profile at the end of that month, and how many backlinks and referring domains were gained and lost during it. Use it to chart link growth, or to report new versus lost links for a period.

Usage

const res = await fetch('https://api.yepapi.com/v1/seo/backlinks/history', {
  method: 'POST',
  headers: {
    'x-api-key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ target: 'stripe.com', date_from: '2026-06-01' }),
});
const { data } = await res.json();
console.log(data.history);

curl -X POST https://api.yepapi.com/v1/seo/backlinks/history \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"target": "stripe.com", "date_from": "2026-06-01"}'

Request Body

Parameter	Type	Required	Description	Default
`target`	`string`	Yes	A domain, e.g. `stripe.com`	—
`date_from`	`string`	No	First month to include, `YYYY-MM-DD`	Earliest month on record
`date_to`	`string`	No	Last month to include, `YYYY-MM-DD`	Today

Response

{
  "ok": true,
  "data": {
    "target": "stripe.com",
    "history": [
      {
        "date": "2026-08-31",
        "rank": 727.0,
        "backlinks": 83520493,
        "newBacklinks": 3668992,
        "lostBacklinks": 11908207,
        "referringDomains": 446545,
        "newReferringDomains": 22287,
        "lostReferringDomains": 14398,
        "referringMainDomains": 394215,
        "referringPages": 59096222,
        "brokenBacklinks": 390707,
        "brokenPages": 11008
      }
    ]
  }
}

Response Fields

Field	Type	Description
`ok`	`boolean`	Whether the request succeeded
`data.target`	`string`	The domain that was analyzed
`data.history`	`object[]`	One entry per month, oldest first
`data.history[].date`	`string`	Last day of the month the snapshot covers (`YYYY-MM-DD`)
`data.history[].rank`	`number`	Authority rank at that date (0–1000)
`data.history[].backlinks`	`number`	Total backlinks at that date
`data.history[].newBacklinks`	`number`	Backlinks first seen during the month
`data.history[].lostBacklinks`	`number`	Backlinks lost during the month
`data.history[].referringDomains`	`number`	Referring domains at that date
`data.history[].newReferringDomains`	`number`	Referring domains gained during the month
`data.history[].lostReferringDomains`	`number`	Referring domains lost during the month
`data.history[].referringMainDomains`	`number`	Referring root domains at that date
`data.history[].referringPages`	`number`	Referring pages at that date
`data.history[].brokenBacklinks`	`number`	Backlinks to pages that no longer resolve
`data.history[].brokenPages`	`number`	Pages with backlinks that no longer resolve

Pricing

$0.05 per call, whatever the date range.