> ## 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 Pages

> List crawled pages from an Ahrefs Site Audit project with technical, content, link, ranking and Core Web Vitals fields, filterable by issue, by any field, and by change versus a compared crawl

List crawled pages from an Ahrefs Site Audit project with technical, content, link, ranking and Core Web Vitals fields, filterable by issue, by any field, and by change versus a compared crawl. Fixed cost of 50 Ahrefs API units per request regardless of rows. Only projects with verified ownership are supported.

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

## Inputs

| Field | Type | Required | Default | Description |
| - | - | - | - | - |
| `project_id` | string or SelectItem | Yes | - | The Site Audit project (numeric ID from the Ahrefs project URL). Only projects with verified ownership are supported. |
| `date` | string | No | - | Crawl to report on, as YYYY-MM-DD or YYYY-MM-DDThh:mm:ss (UTC). Defaults to the most recent crawl. |
| `date_compared` | string | No | - | Earlier crawl to compare against (same format); enables the \*\_prev and \*\_diff fields and filter\_mode. |
| `issue_id` | string | No | - | Only return pages affected by this issue. Get issue IDs from ahrefs\_get\_site\_audit\_issues. |
| `filter_mode` | string or SelectableOption | No | - | With date\_compared: return only pages that were 'added', 'new', 'removed', 'missing' or had 'no\_change' versus the compared crawl. |
| `metrics` | array of string or SelectableOption | No | - | Fields to return (url is always included). Available: http\_code, is\_html, is\_rendered, compliant, page\_is\_noindex, page\_is\_nofollow, meta\_robots, depth, canonical, self\_canonical, canonical\_is\_canonical, redirect, redirect\_code, redirect\_counts, final\_redirect, is\_redirect\_loop, title, titles\_length, nr\_titles, serp\_title, meta\_description, meta\_description\_length, nr\_meta\_description, h1, h1\_length, nr\_h1, h2, html\_lang, hreflang, content\_length, content\_nr\_word, size, size\_uncompressed, loading\_time, time\_to\_first\_byte, links\_count\_internal, links\_count\_external, links\_count\_internal3xx, links\_count\_internal4xx, links\_count\_internal5xx, links\_count\_external4xx, links\_count\_images, links\_count\_images\_without\_alt, incoming\_links, incoming\_follow, incoming\_nofollow, incoming\_redirect, dofollow, nofollow, backlinks, refhosts, refpages, positions, positions\_top3, positions\_top10, traffic, top\_keyword, top\_keyword\_position, page\_type, page\_rating, is\_in\_sitemap, found\_in\_sitemaps, jsonld\_schema\_types, og\_tags\_valid, meta\_twitter\_tags\_valid, duplicate\_content, duplicate\_title, duplicate\_description, duplicate\_h1, ai\_content\_level, ai\_content\_status, allowed\_search\_bots, blocked\_search\_bots, allowed\_training\_bots, blocked\_training\_bots, psi\_lighthouse\_score, psi\_lighthouse\_lcp\_value, psi\_lighthouse\_cls\_value, psi\_lighthouse\_tbt\_value, psi\_crux\_lcp\_percentile, psi\_crux\_lcp\_category, psi\_crux\_cls\_percentile, psi\_crux\_cls\_category, psi\_crux\_inp\_percentile, psi\_crux\_inp\_category, source, origin, stamp. Add \_prev or \_diff to any field when date\_compared is set. Defaults to http\_code, title, meta\_description, h1, canonical, page\_is\_noindex, depth, incoming\_links, links\_count\_internal, content\_nr\_word, size, loading\_time, positions, traffic. |
| `filters` | array of FilterItem | No | - | Filters on the available fields, e.g. http\_code EQUALS 404, page\_is\_noindex EQUALS true or url CONTAINS '/blog/'. |
| `orders` | array of OrderItem | No | - | Sort by one field, e.g. traffic DESC. |
| `limit` | integer | No | `100` | Maximum number of pages to return. Defaults to 100. Fixed cost of 50 API units per request regardless of rows. |
| `offset` | integer | No | - | Number of pages to skip, for paging through large sites. |

### FilterItem

| Field | Type | Required | Default | Description |
| - | - | - | - | - |
| `field` | string or SelectableOption | Yes | - | The field to filter on, must be one of the current selected metrics or dimensions. |
| `operator` | string | Yes | - | The operator to use for filtering. Must be one of the supported values. Use REGEXP\_MATCH to search/filter by multiple OR values like '.*(summer\|holiday).*' |
| `value` | string | Yes | - | The value to filter by, always as a string: text, a number, or a regex. For IN\_LIST and NOT\_IN\_LIST, pass the values as one comma-separated string such as 'a,b,c', not as an array. For regex values, escape backslashes once in the JSON string: write \b for a word boundary, not \b. |

### OrderItem

| Field | Type | Required | Default | Description |
| - | - | - | - | - |
| `field` | string or SelectableOption | Yes | - | The field to sort by. must be one of the current selected metrics or dimensions. |
| `direction` | string | Yes | - | The order to sort by, must be one of 'ASC', 'DESC' |

### 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. |

### SelectableOption

| Field | Type | Required | Default | Description |
| - | - | - | - | - |
| `value` | string | Yes | - | |
| `label` | string | Yes | - | |

## Output

**Type**: `List[Dict]`

Returns one row per page with url plus the selected fields: http\_code, title, meta\_description, h1, canonical, page\_is\_noindex, depth, incoming\_links, links\_count\_internal, content\_nr\_word, size, loading\_time, positions, traffic and any other Page Explorer field, with \_prev / \_diff variants when date\_compared is set. Array fields (title, h1, meta\_description) are comma-joined.

**Fields**: `url`, `http_code`, `title`, `meta_description`, `h1`, `canonical`, `page_is_noindex`, `depth`, `incoming_links`, `links_count_internal`, `content_nr_word`, `size`, `loading_time`, `positions`, `traffic`

**Example**:

```json theme={"dark"}
[
  {
    "url": "https://markifact.com/pricing",
    "http_code": 200,
    "title": "Pricing - Markifact",
    "depth": 1,
    "positions": 12,
    "traffic": 35.0
  }
]
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.