DEVELOPER DOCUMENTATION · V1

Domain data.
On your terms.

A simple JSON API for your applications and workflows.

01 / Authentication

Purchase a separate API plan, then create a key in your workspace. Send it in the Authorization header. Keep it on your server, never in browser code.

Authorization: Bearer YOUR_API_KEY

02 / Analyze a domain

POST /api/v1/analyze/

Accepts a public domain or an HTTP(S) URL. One successful report consumes one API query. Missing metrics are returned as null with their source.

curl --request POST 'https://domainrankings.org/api/v1/analyze/' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{"target":"example.com"}'

Illustrative response

{
  "id": "REPORT_UUID",
  "domain": "example.com",
  "status": "complete",
  "queried_at": "2026-09-20T12:00:00Z",
  "metrics": {
    "da": {"value": 72, "source": "Moz provider"},
    "as": {"value": null, "source": "unavailable"}
  }
}

Supported metric keys: da, pa, as, backlinks, quality_backlinks, quality_percent, dofollow_percent, nofollow_percent, spam_score, moz_trust, seo_score, domain_age.

03 / Check usage

GET /api/v1/usage/

Returns active status, plan name, used queries, query limit and period end. A null limit means Unlimited. Usage checks do not consume query credits.

04 / Errors & limits

Status	Meaning
400	Invalid domain or request body
401	Missing, revoked or invalid API key
403	No active API plan
429	Query quota or per-minute limit reached
503	Provider unavailable or not configured; no query credit consumed