Skip to Content

Link Audit

Audit a domain's backlink quality, anchor profile, risk flags and outbound link concentration in one report.

GEThttps://api.rankparse.com/v1/link-audit8 creditsAPI key

Returns 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

domainstringrequired

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

domainstring

The normalized (lowercased) domain you audited.

health_scoreinteger

Domain-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 strings

Zero or more of no_tranco_presence, low_authority, new_domain and high_authority_new_domain. Same rules as Domain Authority.

link_qualityobject

Counts of sampled backlinks by quality.

Show properties
highinteger

Links rated high.

mediuminteger

Links rated medium.

lowinteger

Links rated low.

totalinteger

The sample size (at most 250).

anchor_profileobject

Share 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_backlinksarray

Up to 10 sampled links from the highest-authority domains. Each entry is one link, so a domain can appear more than once.

Show properties
from_domainstring

The linking domain.

from_domain_scoreinteger

Authority score (0 to 100) of the linking domain, 0 when unknown.

anchor_typestring

branded, partial, naked, generic or image.

link_qualitystring

high, medium or low.

risk_backlinksarray

Up to 10 sampled links rated low, lowest authority first. Same entry shape as top_backlinks.

outbound_summaryobject

Where the domain links out to.

Show properties
unique_destinationsinteger

Number 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 | null

Destination domain of the most frequent record, or null when there are none.

top_domain_concentrationnumber

Share of the examined outbound links that the most frequent record accounts for (0 to 1).

partialboolean

Only present, and always true, when the outbound lookup failed (see below).

credits_usedinteger

Always 8.

credits_remaininginteger

Your balance after this call.

crawl_releasestring

The snapshot the data comes from.

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 low when the linking domain scores below 15 or the anchor is generic, high when the domain scores 40 or more with a branded, partial or naked anchor and no nofollow, and medium otherwise.
  • Anchor type: naked for a URL or bare domain, generic for phrases like "click here" or "read more" and for empty anchors, image for empty image links, branded when the anchor contains the brand name (the first label of the domain, as a whole word when it has 4 or more characters), and partial for everything else.

Behavior and limits

  • Partial results: if the outbound lookup fails, the rest of the audit is still returned with partial: true and an empty outbound_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_domain is 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 200 with zeroed link_quality, an all-zero anchor_profile and empty top_backlinks and risk_backlinks, never 404.
  • Rate limit: 60 requests per minute per key. See Rate limiting.

Errors

HTTPCodeWhen
400invalid_domaindomain is missing or not a valid domain. Checked before the charge: nothing is charged.
401invalid_api_keyMissing, invalid or revoked API key.
402insufficient_creditsBalance is lower than 8 credits.
402spend_cap_reachedYour monthly spend cap is reached.
429rate_limitedMore than 60 requests in a minute.
503query_timeout, upstream_errorTransient data store problem. Retry after the Retry-After header. Credits are refunded.

See Errors for the error body format.

MCP tool: get_link_audit (accepts domain).