Domain Authority

Returns an authority score (0 to 100) based on how many distinct domains link to the target, enriched with domain registration data (RDAP), a popularity rank from the Tranco list, a composite health score and risk flags. The link data comes from the pre-processed link graph snapshot (see Response format). It is the cheapest endpoint and a good first call.

Request

Parameters

Example

curl "https://api.rankparse.com/v1/domain-authority?domain=smartify.in" \
  -H "X-API-Key: rp_your_key"

import requests

res = requests.get(
    "https://api.rankparse.com/v1/domain-authority",
    params={"domain": "smartify.in"},
    headers={"X-API-Key": "rp_your_key"},
    timeout=60,
)
res.raise_for_status()
body = res.json()
if body.get("partial") and body["data"]["score"] is None:
    print("Authority unknown, retry")
else:
    print(body["data"]["score"], body["data"]["risk_flags"])

const params = new URLSearchParams({ domain: "smartify.in" });

const res = await fetch(`https://api.rankparse.com/v1/domain-authority?${params}`, {
  headers: { "X-API-Key": "rp_your_key" },
});
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const { data, partial } = await res.json();
console.log(data.score, data.risk_flags, partial ?? false);

Response

{
  "domain": "smartify.in",
  "data": {
    "score": 76,
    "referring_domains": 340,
    "total_host_count": 18420,
    "registered_at": "2019-03-14T09:21:00Z",
    "registrar": "GoDaddy.com, LLC",
    "popularity_rank": null,
    "health_score": 70,
    "risk_flags": ["no_tranco_presence"]
  },
  "credits_used": 1,
  "credits_remaining": 999
}

Response fields

Top level:

Fields in data:

How the score is calculated

score = min(100, round(log10(referring_domains + 1) * 30)). The scale is logarithmic: about 10 referring domains scores 31, 100 scores 60, and roughly 2,100 or more reaches 100. A domain with no data in the snapshot returns zeros with 200.

How the flags are set

Behavior and limits

• Credits: 1 per call, charged before the lookup.
• Partial results: if the authority lookup times out, the response is 200 with partial: true, score, referring_domains, total_host_count, health_score and risk_flags set to null, and the credit is refunded (credits_used: 0). Treat null as unknown, not as zero authority, and retry. If only the RDAP enrichment degrades, you get the real score with partial: true and null registration fields, and the credit is kept.
• Caching: complete results are cached for 30 days per crawl release. Partial results are never cached. A cache hit is billed the same as a fresh lookup. RDAP data is cached for 30 days and the Tranco list is refreshed weekly.
• Empty results: a domain with no data returns 200 with score: 0, referring_domains: 0 and total_host_count: 0, never 404.
• Rate limit: 60 requests per minute per key. See Rate limiting.

Errors

See Errors for the full list and the error body format.

Related

MCP tool: get_domain_authority (accepts domain).