seo

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.

post/seo/backlinks/page-intersection

Request

  • Base URL: https://api.unifapi.com
  • URL: https://api.unifapi.com/seo/backlinks/page-intersection
  • Auth: HTTP bearer

Headers

Unifapi-Version'2026-07-01'

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-Keystring

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

targetsstring[] required

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

exclude_targetsstring[]

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

intersection_mode'all' | 'partial'

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

backlinks_status_type'live' | 'all' | 'lost'

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

include_subdomainsboolean

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

include_indirect_linksboolean

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

exclude_internal_backlinksboolean

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

internal_list_limitinteger

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

rank_scale'one_hundred' | 'one_thousand'

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

limitinteger

Maximum number of records to return. Defaults to 100.

offsetinteger

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

view'summary' | 'full'

Controls backlink detail. summary keeps link identity and headline rank/anchor data; full adds referring-page details and link attributes. Defaults to summary.

Response

OK

request_idstring required

UnifAPI request id for support and ledger correlation.

Changes

No recorded changes to this operation across all 1 revision of this API.