Ahrefs Domain Rating Free#

Overview#

Use Ahrefs' free public Domain Rating endpoint to check a domain or URL's backlink profile strength. No Ahrefs API key required.

Endpoint:

text

GET https://api.ahrefs.com/v3/public/domain-rating-free?target=<domain-or-url>

Official docs: https://docs.ahrefs.com/en/api/reference/public/get-domain-rating-free

When to Use#

Use this skill when user asks for:

• Ahrefs DR or Domain Rating
• website authority from Ahrefs
• domain authority style checks using Ahrefs data
• quick backlink strength comparison
• free Ahrefs public API lookup
• DR for one domain, many domains, or URLs

Do not use when user needs paid Site Explorer metrics, backlinks, referring domains, organic keywords, or historical Ahrefs data. Those require authenticated Ahrefs API endpoints.

Quick Start#

From this skill directory:

bash

python3 scripts/ahrefs-domain-rating-free.py ahrefs.com
python3 scripts/ahrefs-domain-rating-free.py https://example.com --json
python3 scripts/ahrefs-domain-rating-free.py ahrefs.com example.com github.com

Expected compact output:

text

ahrefs.com  91.0

Agent Workflow#

1. Normalize user input as domain or URL. Keep path if user provided a specific URL.
2. Call the wrapper script first. It handles URL encoding, HTTP errors, JSON parsing, and multi-target output.
3. Report DR as a numeric score on Ahrefs' 100-point logarithmic scale.
4. If comparing multiple targets, sort or tabulate only if user asks.
5. If endpoint returns 400, ask for a valid domain or URL.

Wrapper Script#

bash

python3 scripts/ahrefs-domain-rating-free.py <target...> [--json] [--raw]

Flags:

FlagUse--jsonMachine-readable array with target, domain_rating, ok/error--rawPrint raw Ahrefs JSON per target--timeout SECONDSOverride HTTP timeout, default 20

API Details#

Query parameters:

ParameterRequiredMeaningtargetyesDomain or URL to checkoutputnoAhrefs output selector. Wrapper does not need it.

Response shape:

json

{
  "domain_rating": {
    "domain_rating": 91.0
  }
}

domain_rating.domain_rating is the current strength of the target's backlink profile compared to other websites in Ahrefs' database, on a 100-point logarithmic scale.

Common Mistakes#

• Do not add Authorization header. This public endpoint is free and unauthenticated.
• Do not call /v3/public/domain-rating; correct path is /v3/public/domain-rating-free.
• Do not confuse Ahrefs DR with Moz DA or Semrush Authority Score.
• Do not promise real-time backlink counts. This endpoint returns only DR.
• Handle invalid targets as user input errors, not API outages.

Install#

Skills.sh:

bash

npx skills add AIGC-Hackers/ahrefs-domain-rating-free-skill --skill ahrefs-domain-rating-free

ClawHub, after publish:

bash

clawhub install ahrefs-domain-rating-free
# or
clawdhub install ahrefs-domain-rating-free