> ## Documentation Index
> Fetch the complete documentation index at: https://docs.markifact.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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

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**:

```json theme={"dark"}
[
  {
    "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
  }
]
```