docs / endpoint

POST /v1/backlinks/list

Individual backlinks pointing at a domain or URL.

Credits: 50 credits per call. Timeout: 60s

Parameters

NameTypeRequiredDefaultDescription
target string required — Domain or URL to analyze backlinks for. Required.
limit integer optional 100 Page size. Optional, default 100. 1-1000.
offset integer optional 0 Pagination offset. Optional, default 0. 0-10000.

Request

→ requestPOST /v1/backlinks/list
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.

← response200
{
  "id": "back_7szbfz3wakmedrsns2s3kdnz",
  "request_id": "req_dtcmkor3wffypmerbi3qbbgnyy",
  "object": "backlink_list",
  "created_at": "2026-08-09T07:20:33Z",
  "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.

FieldDescription
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.