List individual backlinks pointing to a target

Return the individual backlinks pointing to a target domain, subdomain, or page, each with the referring URL, anchor, dofollow flag, rank, and spam score, for detailed link auditing.

Pricing — $$ · min $0.05

Minimum 50 credits ($0.05) per call. Records returned above the minimum bill 1 credit ($0.001) each.

Authorization

bearerAuth

AuthorizationBearer <token>

UnifAPI API key. Provider credentials are managed by UnifAPI.

In: header

Pin the API version an integration was built against (date-based, e.g. 2026-07-01). Omit to use the current version. Public URL paths stay stable and unversioned; breaking changes ship under a new dated version and are announced with Deprecation and Sunset response headers. The served version is echoed in every response's Unifapi-Version header. Policy: https://unifapi.com/versioning.md

Idempotency-Key?string

Client-supplied unique key that makes a write request safe to retry. If a request with the same key was already processed, the original response is replayed (with Idempotency-Replayed: true) instead of executing — and billing — again. Send a fresh UUID per logical operation. Best-effort with a 24h window.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

target*string

Domain, subdomain, or page to analyze. A domain or subdomain is specified without https:// and www. (example.com); a page is specified as an absolute URL (https://example.com/blog/).

mode?string

Result grouping: as_is returns every backlink (default), one_per_domain returns one per referring domain, one_per_anchor returns one per anchor.

backlinks_status_type?SeoBacklinksStatusType

Which backlinks to count: live (found on the last check, default), all, or lost.

include_subdomains?boolean

Include backlinks pointing to the target's subdomains. Defaults to true.

include_indirect_links?boolean

Include indirect links (via redirects or canonicals) to the target. Defaults to true.

exclude_internal_backlinks?boolean

Exclude internal backlinks from the target's own subdomains. Defaults to true.

rank_scale?SeoBacklinksRankScale

Scale for rank values: one_thousand (0-1000, default) or one_hundred (0-100).

filters?||

Filter the returned individual backlinks. Provide a single condition {"field","op","value"} or an {"and":[…]} / {"or":[…]} group of conditions (nest groups for mixed logic), up to 8 conditions. Operators: =, <>, <, <=, >, >=, in, not_in, like, not_like, ilike, not_ilike, match, not_match (use an array value with in / not_in). Filterable fields: domain_from (domain of the referring page); url_from (URL of the referring page); url_to (target URL the backlink points to); domain_to (target domain the backlink points to); dofollow (boolean, link is dofollow); is_new (boolean, appeared since the last check); is_lost (boolean, lost since the last check); is_broken (boolean, points to a broken page); rank (referring page rank, 0-1000); page_from_rank (referring page rank, 0-1000); domain_from_rank (referring domain rank, 0-1000); backlink_spam_score (spam score of the referring page, 0-100); item_type (anchor, image, link, redirect, or canonical); anchor (anchor text); tld_from (top-level domain of the referring page); semantic_location (link location, e.g. article, footer); first_seen (ISO date the backlink was first seen); last_seen (ISO date the backlink was last seen). Example: {"and":[{"field":"dofollow","op":"=","value":true},{"field":"is_broken","op":"=","value":false}]}

order_by?array<>

Sort the returned backlinks. Each rule is {"field","dir"} with dir asc or desc; up to 3 rules, applied in order. Sortable fields: domain_from, url_from, url_to, domain_to, dofollow, is_new, is_lost, is_broken, rank, page_from_rank, domain_from_rank, backlink_spam_score, item_type, anchor, tld_from, semantic_location, first_seen, last_seen.

limit?integer

Maximum number of records to return. Defaults to 100.

offset?integer

Number of records to skip from the start of the results.

search_after_token?string

Continuation token from a previous response, used to page past the 20,000-result offset limit. Keep all other parameters identical when paging.

view?string

Response Body

`application/json`

curl -X POST "https://example.com/seo/backlinks/list" \  -H "Content-Type: application/json" \  -d '{    "target": "string"  }'

{  "request_id": "string",  "data": {    "target": "string",    "view": "summary",    "mode": "string",    "total_count": 0,    "search_after_token": "string",    "results": [      {        "domain_from": "string",        "url_from": "string",        "url_to": "string",        "domain_to": "string",        "anchor": "string",        "dofollow": true,        "item_type": "string",        "rank": 0,        "page_from_rank": 0,        "domain_from_rank": 0,        "backlink_spam_score": 0,        "is_new": true,        "is_lost": true,        "is_broken": true,        "first_seen": "string",        "last_seen": "string",        "prev_seen": "string",        "tld_from": "string",        "url_from_https": true,        "url_to_https": true,        "alt": "string",        "image_url": "string",        "text_pre": "string",        "text_post": "string",        "semantic_location": "string",        "attributes": [          "string"        ],        "links_count": 0,        "group_count": 0,        "page_from_title": "string",        "page_from_language": "string",        "page_from_status_code": 0,        "page_from_external_links": 0,        "page_from_internal_links": 0,        "domain_from_country": "string",        "domain_from_platform_type": [          "string"        ],        "url_to_status_code": 0,        "url_to_redirect_target": "string",        "is_indirect_link": true      }    ]  },  "billing": {    "credits_charged": 0,    "records_charged": 0,    "balance_remaining": 0,    "truncated_due_to_balance": true  }}

{  "error": {    "type": "validation_error",    "message": "string",    "request_id": "string",    "issues": [      null    ],    "billing": {      "credits_required": 0,      "credits_charged": 0,      "records_charged": 0,      "balance_remaining": 0,      "truncated_due_to_balance": true    }  }}

{  "error": {    "type": "validation_error",    "message": "string",    "request_id": "string",    "issues": [      null    ],    "billing": {      "credits_required": 0,      "credits_charged": 0,      "records_charged": 0,      "balance_remaining": 0,      "truncated_due_to_balance": true    }  }}

{  "error": {    "type": "validation_error",    "message": "string",    "request_id": "string",    "issues": [      null    ],    "billing": {      "credits_required": 0,      "credits_charged": 0,      "records_charged": 0,      "balance_remaining": 0,      "truncated_due_to_balance": true    }  }}

{  "error": {    "type": "validation_error",    "message": "string",    "request_id": "string",    "issues": [      null    ],    "billing": {      "credits_required": 0,      "credits_charged": 0,      "records_charged": 0,      "balance_remaining": 0,      "truncated_due_to_balance": true    }  }}

{  "error": {    "type": "validation_error",    "message": "string",    "request_id": "string",    "issues": [      null    ],    "billing": {      "credits_required": 0,      "credits_charged": 0,      "records_charged": 0,      "balance_remaining": 0,      "truncated_due_to_balance": true    }  }}

{  "error": {    "type": "validation_error",    "message": "string",    "request_id": "string",    "issues": [      null    ],    "billing": {      "credits_required": 0,      "credits_charged": 0,      "records_charged": 0,      "balance_remaining": 0,      "truncated_due_to_balance": true    }  }}

{  "error": {    "type": "validation_error",    "message": "string",    "request_id": "string",    "issues": [      null    ],    "billing": {      "credits_required": 0,      "credits_charged": 0,      "records_charged": 0,      "balance_remaining": 0,      "truncated_due_to_balance": true    }  }}

{  "error": {    "type": "validation_error",    "message": "string",    "request_id": "string",    "issues": [      null    ],    "billing": {      "credits_required": 0,      "credits_charged": 0,      "records_charged": 0,      "balance_remaining": 0,      "truncated_due_to_balance": true    }  }}

List individual backlinks pointing to a target

Authorization

Header Parameters

Request Body

Response Body

200application/json

400application/json

401application/json

402application/json

404application/json

429application/json

500application/json

502application/json

503application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`