Documentación para desarrolladores

Listar backlinks

GET/sites/{siteId}/backlinks
Permiso
search:read
Herramienta MCP
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.

Las descripciones vienen del documento OpenAPI y están en inglés.

Parámetros

NombreDóndeDetalles
siteIdObligatoriorutastringWebsite 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.

Respuesta

200 · application/json

CampoDetalles
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

Errores

EstadoSignificado
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.

Petición de ejemplo

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

Respuesta de ejemplo

{
  "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"
}

El servidor MCP hace lo mismo con la herramienta backlinks.