Link Audit
Audit a domain's backlink quality, anchor profile, risk flags and outbound link concentration in one report.
https://api.rankparse.com/v1/link-audit8 creditsAPI keyReturns a composite link health report: an overall health score, risk flags, a quality breakdown of recent backlinks, the anchor text profile, the best and riskiest linking domains, and a summary of where the website links out to. Use it for due diligence on a domain you are about to buy, partner with or take over. Data comes from the pre-processed link graph snapshot plus registration and popularity lookups (see Response format).
Query parameters
domainstringrequiredDomain to audit, for example smartify.in. No scheme or path. Must contain a dot.
Response
The audit fields sit at the top level. This endpoint does not wrap them in a data object.
domainstringThe normalized (lowercased) domain you audited.
health_scoreintegerDomain-level score from 0 to 100, built from authority score (up to 40 points), a Tranco popularity rank (20), domain age (20 at 2 years, 30 at 5 years) and at least 10 referring domains (10). Same as health_score on Domain Authority.
risk_flagsarray of stringsZero or more of no_tranco_presence, low_authority, new_domain and high_authority_new_domain. Same rules as Domain Authority.
link_qualityobjectCounts of sampled backlinks by quality.
Show propertiesHide properties
highintegerLinks rated high.
mediumintegerLinks rated medium.
lowintegerLinks rated low.
totalintegerThe sample size (at most 250).
anchor_profileobjectShare of sampled backlinks by anchor type, as fractions from 0 to 1: branded, partial, naked, generic, image. They sum to 1, or are all 0 when there are no backlinks.
top_backlinksarrayUp to 10 sampled links from the highest-authority domains. Each entry is one link, so a domain can appear more than once.
Show propertiesHide properties
from_domainstringThe linking domain.
from_domain_scoreintegerAuthority score (0 to 100) of the linking domain, 0 when unknown.
anchor_typestringbranded, partial, naked, generic or image.
link_qualitystringhigh, medium or low.
risk_backlinksarrayUp to 10 sampled links rated low, lowest authority first. Same entry shape as top_backlinks.
outbound_summaryobjectWhere the domain links out to.
Show propertiesHide properties
unique_destinationsintegerNumber of outbound link records examined (up to 200, the most frequent first). A record is one destination URL, anchor and link type, so it is not a count of distinct domains.
top_domainstring | nullDestination domain of the most frequent record, or null when there are none.
top_domain_concentrationnumberShare of the examined outbound links that the most frequent record accounts for (0 to 1).
partialbooleanOnly present, and always true, when the outbound lookup failed (see below).
credits_usedintegerAlways 8.
credits_remainingintegerYour balance after this call.
crawl_releasestringThe snapshot the data comes from.
How links are rated
link_quality, anchor_profile, top_backlinks and risk_backlinks are derived from the 250 most recent backlinks, not the full profile. health_score and risk_flags are domain-level and do not depend on the sample.
- Quality: a link is
lowwhen the linking domain scores below 15 or the anchor is generic,highwhen the domain scores 40 or more with a branded, partial or naked anchor and nonofollow, andmediumotherwise. - Anchor type:
nakedfor a URL or bare domain,genericfor phrases like "click here" or "read more" and for empty anchors,imagefor empty image links,brandedwhen the anchor contains the brand name (the first label of the domain, as a whole word when it has 4 or more characters), andpartialfor everything else.
Behavior and limits
- Partial results: if the outbound lookup fails, the rest of the audit is still returned with
partial: trueand an emptyoutbound_summary, which then means "unknown", not "no outbound links". Partial responses are billed normally and are not cached. - Credits: 8 per call, charged before the lookup. Server errors are refunded. A request rejected with
invalid_domainis refused before any charge. - Caching: complete results are cached for 30 days per crawl release. A cache hit is billed the same as a fresh lookup.
- Empty results: a domain with no backlinks returns
200with zeroedlink_quality, an all-zeroanchor_profileand emptytop_backlinksandrisk_backlinks, never404. - Rate limit: 60 requests per minute per key. See Rate limiting.
Errors
| HTTP | Code | When |
|---|---|---|
| 400 | invalid_domain | domain is missing or not a valid domain. Checked before the charge: nothing is charged. |
| 401 | invalid_api_key | Missing, invalid or revoked API key. |
| 402 | insufficient_credits | Balance is lower than 8 credits. |
| 402 | spend_cap_reached | Your monthly spend cap is reached. |
| 429 | rate_limited | More than 60 requests in a minute. |
| 503 | query_timeout, upstream_error | Transient data store problem. Retry after the Retry-After header. Credits are refunded. |
See Errors for the error body format.
Related
MCP tool: get_link_audit (accepts domain).