/api/v1/backlinks
Domain Authority Summary & Agency-Filtered Backlink Stream
Retrieves normalized 0–100 Domain Rank, referring domains, dofollow ratio, spam score, CMS/TLD/country/semantic distributions, and up to 1,000 granular backlink rows per request with unlimited cursor pagination and optional CSV streaming. (Cache: 30-Day Vault (Unfiltered) / Live Filtered)
Request Parameters
0 Cr charged on 400 validation errors| Parameter | Type & Default | Description & Allowed Values |
|---|---|---|
domain
REQ |
string
def: —
|
Target root domain (e.g. ahrefs.com). |
include_links
|
0 | 1
def: 0
|
0 = Authority Summary & distributions only (30 Cr). 1 = Include granular top_backlinks[] rows. |
limit
|
integer
def: 50
|
Backlinks per page (10 to 1,000). Usage-billed per 100 actually returned rows. |
cursor
|
string
def: null
|
Opaque pagination.next_cursor token from prior response for unlimited Page 2+ streaming (skips Summary automatically). |
offset / links_only
|
int / 0|1
def: 0 / 0
|
Integer offset up to 10,000 (use cursor past 10K). links_only=1 skips Summary on Page 1. |
link_mode
|
enum
def: "as_is"
|
"as_is" (all links), "one_per_domain" (1 best link per referring domain), or "one_per_anchor". |
dofollow_only
|
0 | 1
def: 0
|
Set 1 to return only dofollow backlinks. |
platform_type / cms
|
string
def: null
|
Filter by referring site CMS/platform: cms, blogs, ecommerce, news, wikis, forums, message-boards, organization, etc. |
backlink_type
|
enum
def: null
|
Filter by HTML link element: anchor, image, link, redirect, canonical, meta, alternate. |
status
|
enum
def: "live"
|
Link lifecycle filter: "live", "lost", or "all". |
min_rank / max_spam_score
|
int (0–100)
def: 0 / null
|
Minimum referring domain rank (0–100) and maximum allowed backlink spam score (0–100). |
tld / anchor / semantic_location
|
string / enum
def: null
|
Filter by TLD (e.g. edu, gov, co.uk), anchor substring, or HTML placement (article, main, section, header, footer, aside, nav, details). |
broken_only / exclude_broken / new_only
|
0 | 1
def: 0
|
Boolean quality filters for broken-link prospecting or freshly acquired links. |
sort_by
|
enum
def: "rank_desc"
|
Sort order: "rank_desc", "page_rank_desc", "first_seen_desc", or "spam_asc". |
format / mode
|
enum
def: "json" / "auto"
|
format="json"|"csv" (RFC-4180 stream). mode="sandbox"|"vault"|"live"|"auto". |