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

### 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",
    "meta_description": "Simple pricing for marketing automation.",
    "h1": "Pricing",
    "canonical": "https://markifact.com/pricing",
    "page_is_noindex": false,
    "depth": 1,
    "incoming_links": 38,
    "links_count_internal": 42,
    "content_nr_word": 610,
    "size": 48211,
    "loading_time": 412,
    "positions": 12,
    "traffic": 35.0
  }
]
```
