Find pages linking to multiple targets

Return the referring pages that link to a set of targets, with the backlinks to each target. Useful for finding pages that link to your competitors but not to your site.

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

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

targets*array<>

Domains, subdomains, or pages to find common referring pages for (1-20). Order is preserved as the 1-based index in the response.

Items1 <= items <= 20

exclude_targets?array<>

Domains, subdomains, or pages to exclude (up to 10). Pages linking to these are dropped.

Itemsitems <= 10

intersection_mode?string

all (default) returns pages linking to any target; partial returns only pages linking to every target.

Value in"all" | "partial"

backlinks_status_type?SeoBacklinksStatusType

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

Value in"live" | "all" | "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.

internal_list_limit?integer

Maximum number of entries kept in each referring_links_* breakdown map. Defaults to 10.

Range1 <= value <= 1000

rank_scale?SeoBacklinksRankScale

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

Value in"one_hundred" | "one_thousand"

filters?||

Filter the intersecting referring pages. Prefix each backlink field with the 1-based target index, e.g. 1.dofollow, 2.rank. 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: 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: {"field":"1.dofollow","op":"=","value":true}

order_by?array<>

Sort the intersecting referring pages. Prefix each field with the 1-based target index, e.g. 1.rank. Each rule is {"field","dir"} with dir asc or desc; up to 3 rules, applied in order. Sortable fields: 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.

Items1 <= items <= 3

limit?integer

Maximum number of records to return. Defaults to 100.

Range1 <= value <= 1000

offset?integer

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

Range0 <= value

view?string

Value in"summary" | "full"

Response Body

`application/json`

curl -X POST "https://example.com/seo/backlinks/page-intersection" \  -H "Content-Type: application/json" \  -d '{    "targets": [      "string"    ]  }'

{
  "request_id": "string",
  "data": {
    "targets": [
      "string"
    ],
    "view": "summary",
    "total_count": 0,
    "results": [
      {
        "url_from": "string",
        "domain_from": "string",
        "intersections_count": 0,
        "links_to": [
          {
            "target": "string",
            "links": [
              {
                "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
    }
  }
}

Find pages linking to multiple targets

Authorization

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`