Ahrefs Domain Rating

Fetch Domain Rating with the free public endpoint. Free means Ahrefs does not charge API units. It does not mean open access. A missing Bearer token returns 403 Forbidden. Always send a free APIv3 key.

Always fetch the current docs first. Never pipe through head, tail, sed -n, awk, | less, or any command that truncates:

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

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

Auth

API key lives in ~/.config/opencode/skills/ahrefs-dr/.env as AHREFS_API_KEY. Load it. Never print the key. Never commit .env. If the value is empty, stop and ask the user to paste a key from https://app.ahrefs.com/account/api-keys

set -a
source ~/.config/opencode/skills/ahrefs-dr/.env
set +a
test -n "$AHREFS_API_KEY"

Free account is enough. Generate the key in Account settings → API keys. Send it as Authorization: Bearer <token>.

Get DR

target is required. Pass a domain or a URL. Use --data-urlencode so query chars stay valid.

curl -sS --fail-with-body -G 'https://api.ahrefs.com/v3/public/domain-rating-free' \
  --data-urlencode 'target=playwriter.dev' \
  -H 'Accept: application/json' \
  -H "Authorization: Bearer $AHREFS_API_KEY"

Response:

{
  "domain_rating": {
    "domain_rating": 20.0,
    "license": "http://ahrefs.com/legal/domain-rating-license"
  }
}

Print the number as DR. Always add attribution: Domain Rating by Ahrefs (https://ahrefs.com/). License: http://ahrefs.com/legal/domain-rating-license

Rules

• Always use this free public endpoint. Do not call paid Site Explorer endpoints for DR.
• Pass the host only when the user gives a full URL unless they ask for that exact URL as target.
• On 401, the key is missing or invalid. Stop. Do not retry with a guessed key.
• On 429, wait and retry once. Do not loop.