# POST /v1/backlinks/list

Individual backlinks pointing at a domain or URL.

**Credits:** 50 credits per call.

**Timeout:** 60s

## Parameters

| Name | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `target` | string | yes | — | Domain or URL to analyze backlinks for. Required. |
| `limit` | integer | no | 100 | Page size. Optional, default 100. 1-1000. |
| `offset` | integer | no | 0 | Pagination offset. Optional, default 0. 0-10000. |

## Request

```http
POST /v1/backlinks/list HTTP/1.1
Authorization: Bearer sof_live_your_key_here
Content-Type: application/json

{
  "target": "example.com",
  "limit": 100,
  "offset": 0
}
```

## Response

Wrapped in the standard envelope (id, object, created_at, elapsed_ms, cache, credits) -- documented once on The Contract. The body below is a real envelope with this endpoint's `data` shape; values vary per request, and a `…` marks an array cut short for display.

```json
{
  "id": "back_fq22dkgbp66d43xaq44bpfuh",
  "request_id": "req_tx2uokwnzbgyla3khns3uyascy",
  "object": "backlink_list",
  "created_at": "2026-08-09T08:26:08Z",
  "elapsed_ms": 180,
  "cache": "miss",
  "credits": {
    "charged": 50,
    "balance": 9857
  },
  "data": {
    "target": "example.com",
    "total_count": 355648,
    "limit": 100,
    "offset": 0,
    "items": [
      {
        "source_url": "https://blog.example.net/best-shoes",
        "target_url": "https://example.com/",
        "source_domain": "blog.example.net",
        "target_domain": "example.com",
        "anchor": "running shoes guide",
        "dofollow": true,
        "first_seen": "2024-03-11",
        "last_seen": "2026-06-02",
        "authority": 54,
        "spam_score": 0
      },
      "…"
    ]
  }
}
```

## Response fields

What each field in `data` (above) means.

| Field | Description |
| --- | --- |
| `data.target` | The domain or URL you requested. |
| `data.total_count` | Total number of rows matching the target, independent of limit/offset. |
| `data.limit` | Page size actually used (echoes the request). |
| `data.offset` | Pagination offset actually used (echoes the request). |
| `data.items` | One row per backlink, up to limit. |
| `data.items[].source_url` | URL of the page carrying the link. |
| `data.items[].target_url` | URL the link points at. |
| `data.items[].source_domain` | Registrable domain of the linking page. |
| `data.items[].target_domain` | Registrable domain of the destination. |
| `data.items[].anchor` | Anchor text of the link. |
| `data.items[].dofollow` | true if the link passes authority (no nofollow/sponsored/ugc attribute). |
| `data.items[].first_seen` | Date this backlink was first observed. |
| `data.items[].last_seen` | Date this backlink was last confirmed live. |
| `data.items[].authority` | 0-100 authority score of the linking page. |
| `data.items[].spam_score` | 0-100 spam score of the linking page. |