Get Site Audit Health

Get Site Audit health scores from Ahrefs for one or all projects: health score, crawl status and date, URLs crawled, and URLs with errors, warnings and notices, for the latest or a past crawl. Projects whose crawl has never finished, or is still running, come back with null crawl fields. Free: does not consume API units. Use the returned date as the crawl timestamp for ahrefs_get_site_audit_issues and ahrefs_get_site_audit_pages.


App	Ahrefs
Operation ID	`ahrefs_get_site_audit_health`
Type	Action
Connection	`ahrefs` (required)
Credits per run	Free
Agent / MCP tool	Yes

Inputs

Field	Type	Required	Default	Description
`project_id`	string or SelectItem	No	-	A Site Audit project (numeric ID from the Ahrefs project URL). Leave empty for every project in the workspace.
`date`	string	No	-	Crawl to report on, as YYYY-MM-DD or YYYY-MM-DDThh:mm:ss (UTC). Defaults to the most recent crawl.

SelectItem

Field	Type	Required	Default	Description
`value`	string	Yes	-	The value of the selectable item.
`label`	string	Yes	-	The label of the selectable item, used for display purposes. If not provided, defaults to the value.

Output

Type: List[Dict] Returns one row per project: project_id, project_name, target_url, target_mode, target_protocol, date (crawl timestamp), status, health_score, total, urls_with_errors, urls_with_warnings, urls_with_notices. The crawl fields are null until a crawl has finished, including while one is still running, so a null health_score means no completed crawl rather than a perfect site. Fields: project_id, project_name, target_url, date, status, health_score, total, urls_with_errors, urls_with_warnings, urls_with_notices Example:

[
  {
    "project_id": "8070430",
    "project_name": "Markifact",
    "target_url": "markifact.com/",
    "target_mode": "subdomains",
    "target_protocol": "both",
    "date": "2026-09-01T03:12:44Z",
    "status": "Completed",
    "health_score": 92,
    "total": 412,
    "urls_with_errors": 6,
    "urls_with_warnings": 48,
    "urls_with_notices": 120
  }
]

Get Started

Guides

Operations

Get Site Audit Health

Inputs

SelectItem

Output

​Inputs

​SelectItem

​Output

Inputs

SelectItem

Output