# POST /v1/backlinks/domains

Domains that link to a target, with per-domain metrics.

**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/domains 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": "refe_4jhnjn76syntbfcz4al6urrm",
  "request_id": "req_53flmalmkndg5ged4zbaipsalq",
  "object": "referring_domains",
  "created_at": "2026-08-09T08:32:14Z",
  "elapsed_ms": 180,
  "cache": "miss",
  "credits": {
    "charged": 50,
    "balance": 9857
  },
  "data": {
    "target": "example.com",
    "total_count": 3160,
    "limit": 100,
    "offset": 0,
    "items": [
      {
        "domain": "caglrc.cc",
        "backlinks": 526,
        "first_seen": "2023-11-02",
        "lost_at": null,
        "authority": 27,
        "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 referring domain, up to limit. |
| `data.items[].domain` | The referring domain. |
| `data.items[].backlinks` | Number of backlinks from this domain to the target. |
| `data.items[].first_seen` | Date a link from this domain was first observed. |
| `data.items[].lost_at` | Date the last link from this domain was lost, or null if it's still linking. |
| `data.items[].authority` | 0-100 authority score of the referring domain. |
| `data.items[].spam_score` | 0-100 spam score of the referring domain. |