# POST /v1/backlinks/summary

Backlink profile summary metrics for a domain or URL.

**Credits:** 20 credits per call.

**Timeout:** 60s

## Parameters

| Name | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `target` | string | yes | — | Domain or URL to analyze backlinks for. Required. |

## Request

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

{
  "target": "example.com"
}
```

## 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_o2l3o2un5u6iuwxsnyb5ofpv",
  "request_id": "req_2ezozgnqzjcc5eknts5llvz5vu",
  "object": "backlink_summary",
  "created_at": "2026-08-09T08:27:29Z",
  "elapsed_ms": 180,
  "cache": "miss",
  "credits": {
    "charged": 20,
    "balance": 9857
  },
  "data": {
    "target": "example.com",
    "authority": 33,
    "backlinks": 617091,
    "spam_score": 9,
    "referring_domains": 3582,
    "referring_root_domains": 3160,
    "referring_pages": 210044,
    "link_breakdown": {
      "tlds": {
        "com": 2891,
        "net": 412,
        "org": 279
      },
      "types": {
        "anchor": 17226,
        "image": 421,
        "redirect": 12
      },
      "attributes": {
        "nofollow": 1769,
        "ugc": 340,
        "external": 88,
        "sponsored": 26
      },
      "platforms": {
        "blogs": 3021,
        "cms": 1104,
        "news": 214
      },
      "page_sections": {
        "article": 12904,
        "footer": 2200,
        "section": 1122
      },
      "countries": {
        "US": 9821,
        "GB": 2011,
        "DE": 1502
      }
    }
  }
}
```

## Response fields

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

| Field | Description |
| --- | --- |
| `data.target` | The domain or URL you requested. |
| `data.authority` | 0-100 authority score for the target (higher is stronger). |
| `data.backlinks` | Total backlink count pointing at the target. |
| `data.spam_score` | 0-100 spam score for the target's backlink profile (higher is spammier). |
| `data.referring_domains` | Number of distinct domains linking to the target. |
| `data.referring_root_domains` | Number of distinct registrable (root) domains linking to the target -- referring_domains collapsed to one per apex. |
| `data.referring_pages` | Number of distinct pages linking to the target. |
| `data.link_breakdown` | Backlink counts broken down along six axes: tlds, types, attributes, platforms, page_sections, countries. |
| `data.link_breakdown.tlds` | Backlink counts by source TLD. |
| `data.link_breakdown.types` | Backlink counts by link type (anchor, image, redirect, ...). |
| `data.link_breakdown.attributes` | Backlink counts by link attribute (nofollow, ugc, external, sponsored, ...). |
| `data.link_breakdown.platforms` | Backlink counts by source platform (blogs, cms, news, ...). |
| `data.link_breakdown.page_sections` | Backlink counts by the page section the link appeared in (article, footer, section, ...). |
| `data.link_breakdown.countries` | Backlink counts by source country (ISO country code). |