docs / endpoint

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	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/domains

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.

← response200

{
  "id": "refe_wbcprz5ntijpaumlkjoptvee",
  "request_id": "req_mozc7rudhnczpfl2yqvo2hkrba",
  "object": "referring_domains",
  "created_at": "2026-08-09T07:23:27Z",
  "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.