Backlinks List

POST/v1/seo/backlinks/list

from $0.05 + $0.01/100 rows

Pricing

$0.05 per call + $0.01 per 100 rows, rounded up to the next whole cent.

Rows returned	Cost per call
1 row	$0.06
10 rows	$0.06
50 rows	$0.06
100 rows	$0.06
250 rows	$0.08
500 rows	$0.10
1,000 rows	$0.15

Billed on the number of results actually returned, not the number requested. Failed calls are never charged.

Usage

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

curl -X POST https://api.yepapi.com/v1/seo/backlinks/list \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"target": "vercel.com", "limit": 100}'

Request Body

Parameter	Type	Required	Description	Default
`target`	`string`	Yes	A domain (`stripe.com`), a subdomain (`docs.stripe.com`), or one exact page as a full URL (`https://stripe.com/pricing`). A subfolder such as `stripe.com/docs/` is not supported.	—
`limit`	`number`	No	Maximum number of backlinks to return (max `1000`)	`100`
`offset`	`number`	No	Rows to skip, for paging past `limit` (max `20000`). `data.total` tells you how many rows exist.	`0`
`mode`	`string`	No	`as_is` returns every link; `one_per_domain` returns the strongest link from each referring domain; `one_per_anchor` one per anchor text.	`"as_is"`
`status`	`string`	No	`live`, `lost`, or `all`.	`"live"`
`dofollow`	`boolean`	No	`true` for dofollow links only, `false` for nofollow only.	—
`broken`	`boolean`	No	`true` for links pointing at pages that no longer resolve.	—
`sort`	`string`	No	`field:asc` or `field:desc`. Fields: `rank`, `domain_authority`, `spam_score`, `first_seen`, `last_seen`.	`"rank:desc"`

# Newest dofollow links, one per referring domain, second page of 100
curl -X POST https://api.yepapi.com/v1/seo/backlinks/list \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"target": "stripe.com", "limit": 100, "offset": 100, "mode": "one_per_domain", "dofollow": true, "sort": "first_seen:desc"}'

An option this endpoint does not support returns a 400 rather than being ignored.

Response

{
  "ok": true,
  "data": {
    "target": "vercel.com",
    "total": 1284033,
    "backlinks": [
      {
        "anchor": "Vercel",
        "dofollow": true,
        "domainAuthority": 532.0,
        "firstSeen": "2025-07-01",
        "from": "https://ui.shadcn.com/",
        "fromDomain": "ui.shadcn.com",
        "lastSeen": "2026-03-15",
        "spamScore": 0.0,
        "status": "active",
        "rank": 412.0,
        "isBroken": false,
        "to": "https://vercel.com/new?utm_source=shadcn_site&utm_medium=web&utm_campaign=docs_cta_deploy_now_callout"
      },
      {
        "anchor": "Official site",
        "dofollow": true,
        "domainAuthority": 389.0,
        "firstSeen": "2025-12-05",
        "from": "https://dedoo.xyz/",
        "fromDomain": "dedoo.xyz",
        "lastSeen": "2026-02-19",
        "spamScore": 0.0,
        "status": "active",
        "rank": 301.0,
        "isBroken": false,
        "to": "https://lebowskis.vercel.com/"
      }
    ]
  }
}

Response Fields

Field	Type	Description
`ok`	`boolean`	Whether the request succeeded
`data.target`	`string`	The target domain that was analyzed
`data.total`	`number`	How many backlinks match in total, regardless of `limit` and `offset`
`data.backlinks`	`array`	List of individual backlinks pointing to the target
`data.backlinks[].anchor`	`string`	The anchor text used in the backlink
`data.backlinks[].dofollow`	`boolean`	Whether the link passes link equity (dofollow)
`data.backlinks[].domainAuthority`	`number`	Authority score of the referring domain
`data.backlinks[].firstSeen`	`string`	Date the backlink was first discovered
`data.backlinks[].from`	`string`	Full URL of the page containing the backlink
`data.backlinks[].fromDomain`	`string`	Domain of the page containing the backlink
`data.backlinks[].lastSeen`	`string`	Date the backlink was last confirmed active
`data.backlinks[].spamScore`	`number`	Spam likelihood score of the referring domain (0-100)
`data.backlinks[].status`	`string`	`active`, `new`, or `lost`
`data.backlinks[].rank`	`number`	Rank of the link itself (0–1000)
`data.backlinks[].isBroken`	`boolean`	The linked page no longer resolves
`data.backlinks[].to`	`string`	Full destination URL the backlink points to

Under the Hood

Queries backlink index in real-time. Results sorted by domain rank.