Developer docs

List backlinks

GET/sites/{siteId}/backlinks
Scope
search:read
MCP tool
backlinks

Backlink summary and referring domains The latest link summary with the change over 28 days, and the referring domains of one view: all (live), new (first seen in the last 30 days), lost, review (high spam score or many links at once), strong (domain strength 50 or more). Estimates, refreshed weekly.

Parameters

NameInDetails
siteIdRequiredpathstringWebsite id, from GET /sites.
viewqueryallnewlostreviewstrongdefault allWhich referring domains to list.
dofollowquery1trueOnly dofollow domains.
sortquerylinksstrengthrecentspamdomainanchortypedefault linksColumn to sort by.
dirqueryascdescDefault asc for domain, anchor and type, else desc. Rows without a value come last.
pagequeryintegerdefault 1, min 1Page number, from 1.
perqueryintegerdefault 50, min 1, max 200Rows per page, 1 to 200.

Response

200 · application/json

FieldDetails
summaryobject or null · required; null before the first backlink refresh
summary.datedate (YYYY-MM-DD) · required; Day of the latest numbers
summary.referringDomainsinteger · required; Domains linking to the website
summary.backlinksinteger · required; Links to the website
summary.dofollowinteger · required; Dofollow links
summary.domainRankinteger or null · required; Domain strength, 0–100
summary.new28Daysinteger · required; New referring domains in the period shown
summary.lost28Daysinteger · required; Lost referring domains in the period shown
summary.monthAgoobject or null · required; The numbers about a month before
summary.monthAgo.datedate (YYYY-MM-DD) · required; Day
summary.monthAgo.referringDomainsinteger · required; Domains linking
summary.monthAgo.backlinksinteger · required; Links
summary.monthAgo.domainRankinteger or null · required; Domain strength
viewall | new | lost | review | strong · required; The view listed
countsobject · required; Domains per view
counts.allinteger · required; Live domains
counts.newinteger · required; New in 30 days
counts.lostinteger · required; Lost
counts.reviewinteger · required; Worth a look
counts.stronginteger · required; Strength 50 or more
counts.reclaiminteger · required; Lost links to pages of ours worth reclaiming (domains)
totalinteger · required; Rows that match, over all pages
pageinteger · required; This page, from 1
perinteger · required; Rows per page
hasMoretrue or false · required; More rows after this page
domainslist of values · required
domains[].domainstring
domains[].domainRanknumber
domains[].backlinksnumber
domains[].firstSeenstring
domains[].lostAt
domains[].topAnchorstring
domains[].dofollowtrue or false
domains[].spamScorenumber
domains[].sampleUrlslist of strings
domains[].reviewedtrue or false
domains[].disavowtrue or false
domains[].reviewSuggestedtrue or false
domains[].linkstring
notestring · required; How to read the numbers
linkaddress (URL) · required; The Backlinks screen in the app

Errors

StatusMeaning
400Bad request. Codes: bad_view, bad_sort, bad_dir, bad_page, bad_per.
401Missing, unknown or revoked key. Codes: missing_key, invalid_key.
403The key lacks the scope, covers another website, or its owner lost access. Codes: missing_scope, other_site, owner_left, no_owner, forbidden.
404Not found. Codes: not_found.
429Too many requests this hour for this key. Codes: rate_limited.

Example request

curl \
  -H "Authorization: Bearer mr_ws_…" \
  "https://app.monoranks.com/api/v1/sites/SITE_ID/backlinks"

Example response

{
  "summary": {
    "date": "2026-10-04",
    "referringDomains": 286,
    "backlinks": 3412,
    "dofollow": 2710,
    "domainRank": 33,
    "new28Days": 9,
    "lost28Days": 4,
    "monthAgo": {
      "date": "2026-09-06",
      "referringDomains": 281,
      "backlinks": 3360,
      "domainRank": 32
    }
  },
  "view": "all",
  "counts": {
    "all": 286,
    "new": 9,
    "lost": 41,
    "review": 3,
    "strong": 22,
    "reclaim": 2
  },
  "total": 286,
  "page": 1,
  "per": 50,
  "hasMore": true,
  "domains": [
    {
      "domain": "trailnews.example",
      "domainRank": 58,
      "backlinks": 14,
      "firstSeen": "2025-03-11",
      "lostAt": null,
      "topAnchor": "Acme Bikes",
      "dofollow": true,
      "spamScore": 2,
      "sampleUrls": [
        "https://trailnews.example/gear/gravel-tire-test/"
      ],
      "reviewed": false,
      "disavow": false,
      "reviewSuggested": false,
      "link": "https://app.monoranks.com/sites/3f6c2a1e-8b4d-4c7a-9e21-5d0b7a6f4c13/backlinks/trailnews.example"
    }
  ],
  "note": "Counts, domain strength and spam score are estimates, refreshed weekly.",
  "link": "https://app.monoranks.com/sites/3f6c2a1e-8b4d-4c7a-9e21-5d0b7a6f4c13/backlinks"
}

The MCP server does the same with the tool backlinks.