Backlinks
GET /seo/backlinks — referring-domain and link-profile metrics for a domain or a single page.
Link-profile metrics for a target. Scope the analysis to a whole domain or to one specific page.
Backlinks are entitlement-gated
Backlink data requires the capability to be enabled on the account. Without it the request returns 403 BACKLINKS_NOT_ENABLED, and a billing problem on an otherwise-entitled account returns 402 BACKLINKS_BILLING_ISSUE.
/seo/backlinksQuery parameters
projectIdstringqueryrequiredOwning project.
targetstringqueryrequiredThe domain or URL to analyse.
scopestringquerydefault: domaindomain or page. Any value other than page is treated as domain.
Response fields
overviewobjectThe backlink metrics payload.
curl "https://api.misar.io/seo/backlinks?projectId=5b1c7d2e-…&target=acme.com&scope=domain" \
-H "Authorization: Bearer $MISARSEO_API_KEY"curl "https://api.misar.io/seo/backlinks?projectId=5b1c7d2e-…&target=https://acme.com/pricing&scope=page" \
-H "Authorization: Bearer $MISARSEO_API_KEY"{ "error": "Backlinks are not enabled for this account", "code": "BACKLINKS_NOT_ENABLED" }Rate limit: 20 requests per 60 s.
`scope` is fail-safe, not strict
An unrecognised scope does not error — it falls back to domain. If you intended page-level analysis, spell page exactly, and pass a full URL as target.
Status codes
| Code | Meaning |
|---|---|
200 | Metrics returned |
400 | VALIDATION_ERROR — missing projectId or target |
401 | UNAUTHENTICATED |
402 | BACKLINKS_BILLING_ISSUE |
403 | BACKLINKS_NOT_ENABLED |
404 | NOT_FOUND — project not found |
429 | RATE_LIMITED |
501 | SEO_DATA_UNAVAILABLE — no honest backlink source in this deployment's data mode |
Backlinks have no free data source
There is no honest public source for a full link graph. In free data mode this endpoint returns 501 SEO_DATA_UNAVAILABLE rather than a partial or invented profile. Backlink coverage requires the paid data mode.