SaaS Pro Max
Sign inStart free
Documentation menu

SEO

Track daily Ahrefs Domain Rating for your application's domains and competitors. The Authority page keeps DR3 and DR4 side by side, with a history chart and a comparison of the latest scores. This module tracks production domains and is available on every plan.

  • Enable SEO under Settings > Modules. It is off by default.
  • Permissions: analytics.read to view; analytics.write to track, rename, pause, remove or check domains. These changes do not require a fresh passkey.
  • Operator setup: the installation needs SPM_AHREFS_API_KEY. Without it, Authority shows "Domain rating is not configured on this installation" and does not offer forms. No tenant credential is needed.

Track a domain#

  1. Open SEO > Authority, then choose Track a domain. The first form suggests the hostname of your application's URL when it is a public domain.
  2. Enter a host such as example.com, an optional label and a kind: Your domain or Competitor. A URL is accepted and normalized to its hostname.
  3. Save. Values arrive within a few minutes of adding a domain, then once a day. Choose a domain and Last 30 days, Last 90 days or Last 12 months to read its history.

Subdomains remain separate, including www.example.com and example.com. Use the exact host you want to compare. Private hosts, IP addresses and localhost are not supported.

Manage domains lets writers rename a label and pause or resume daily checks. Pausing keeps history. Removing a domain requires a confirmation checkbox and deletes its history. Check now queues checks for enabled domains; it is available when no enabled domain was checked within the last hour. Members with read access see status without management forms.

DR3 and DR4#

Domain Rating is Ahrefs' measure of a domain's link authority, on a scale from 0 to 100. DR3 is the earlier model; DR4 is the newer model. Ahrefs makes DR4 the default on 1 December 2026. DR4 rates each subdomain separately and counts links differently, so many scores fall without any change to the site. DR3 will stop updating when Ahrefs withdraws it from its API; existing history remains available.

Before 1 December, Domain Rating uses DR3 and the other tile is DR4 preview. From that date, it uses DR4 and the other tile is DR3 legacy. If the default model has no value, the headline uses the other model and names that fallback. Change is the default model's last value minus its first value within the chosen period. DR4 minus DR3 compares the latest values of the two models, which may have different observation dates.

The chart draws both models and marks 1 December 2026 when it falls in the selected period. Days without a value are gaps. Missing figures use an em dash, not zero; a reported zero is a real rating.

Limits and attribution#

  • Track at most eight domains per application, including competitors.
  • Each model keeps one value per UTC day. The provider supplies today's value; earlier history cannot be backfilled. History is kept until the domain is removed.
  • Values come from Ahrefs. Provider errors or limits can delay a check; previous values remain visible with the target's status.
  • Every place that displays or returns a rating requires the credit Domain Rating by Ahrefs. Management API read responses include attribution; keep the credit when displaying their values. Raw ratings cannot be resold or exported in bulk across tenants.

See the Ahrefs Domain Rating licence.

Management API#

Use a Management API token with access to the application and the permissions below. Paths are relative to /api/v1; the SEO module must be enabled. Targets use the production environment. Report query parameters are env=production, days=30|90|365 (default 90) and optional target (target ID).

Method and pathPermissionBody or purpose
GET /apps/{app}/seo/authorityanalytics.readReport, selected history and attribution
GET /apps/{app}/seo/targetsanalytics.readTracked domains and attribution
POST /apps/{app}/seo/targetsanalytics.writehost, optional label, `kind: own
PUT /apps/{app}/seo/targets/{id}analytics.writerevision, label, enabled (boolean)
POST /apps/{app}/seo/targets/{id}/removeanalytics.writerevision; deletes the target and history
POST /apps/{app}/seo/authority/refreshanalytics.writeQueue a check for enabled domains

Updates and removal require the current revision. A changed revision returns a conflict; read the latest target before retrying. MCP exposes the same operations as seo_get_authority, seo_list_targets, seo_add_target, seo_update_target, seo_remove_target and seo_refresh_authority.

Not included yet#

This page does not provide backlink lists, search rankings, keyword research, site crawling or a technical SEO audit. It does not infer traffic or revenue from a rating. Search Console reporting remains in Revenue > Acquisition > Organic search.