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

# List Crawled Pages

> A paginated inventory of pages discovered or crawled for a brand, with scores and status.

A paginated inventory of every page SnowSEO has discovered or crawled for the brand, subdomains included, with its SEO, technical, content, and GEO scores, title, and PageSpeed scores where available. Pages excluded by the brand's crawl rules are returned and flagged rather than hidden.

Pass `analyticsProvider` (`ga`, `posthog`, `plausible` or `snow`) to add each page's visitor count, over `startDate` and `endDate` or `days` (see [Date Windows](https://snowseo.com/docs/api-reference/introduction.md#date-windows)). Sorting by `visitors` without it returns `400`.

With `fields=summary` the response carries counts only: `summary` includes `pageSpeedTested`, the number of pages with a PageSpeed result, and `pageSpeedLastTestedAt`, the most recent PageSpeed test time across them.


## OpenAPI

````yaml GET /v3/seo-audit/crawled-pages
openapi: 3.0.0
info:
  title: SnowSEO API
  description: API documentation for SnowSEO
  version: 1.0.0
servers:
  - url: https://api.snowseo.com
    description: Production server
security:
  - bearerAuth: []
  - apiKey: []
externalDocs:
  url: https://snowseo.com/docs
  description: Find more info here
paths:
  /v3/seo-audit/crawled-pages:
    get:
      tags:
        - SEO Audit
      summary: List crawled pages for a site
      description: >-
        A paginated inventory of pages SnowSEO has discovered or crawled for
        this site, with its SEO/technical/content/GEO scores, title, HTTP
        status, and mobile PageSpeed score where available. Pages excluded by
        the team's crawl rules are returned and flagged rather than hidden.
        Returns filtered totals and audit counts alongside the current page. Use
        pageSize=all only for explicit exports or full-dataset consumers.
      operationId: listCrawledPages
      parameters:
        - schema:
            type: string
          in: query
          name: teamId
          required: true
          description: SnowSEO team ID, as returned by list_teams.
        - schema:
            type: integer
          in: query
          name: page
          required: false
          description: 1-based page. Default 1.
        - schema:
            type: string
          in: query
          name: pageSize
          required: false
          description: >-
            Rows per page (max 1000), or 'all'. Every response reports total and
            totalPages.
        - schema:
            type: string
          in: query
          name: search
          required: false
          description: Matches the page URL or title.
        - schema:
            type: string
            enum:
              - page
              - url
              - visitors
              - indexingVerdict
              - technical
              - content
              - geo
              - pageSpeed
              - lastAuditedAt
              - performance
              - accessibility
              - bestPractices
              - seo
              - fetchedAt
              - lastIndexNowSubmittedAt
          in: query
          name: sortBy
          required: false
        - schema:
            type: array
            items:
              type: string
          in: query
          name: omitUrls
          required: false
          description: Pages to leave out. Repeat for several URLs.
        - schema:
            type: array
            items:
              type: string
          in: query
          name: issueIds
          required: false
          description: >-
            Only pages where any of these catalogue issues is unresolved in the
            latest audit.
        - schema:
            type: string
            enum:
              - ga
              - posthog
              - plausible
              - snow
          in: query
          name: analyticsProvider
          required: false
          description: >-
            Connected analytics integration to read page visitors from: ga
            (Google Analytics), posthog, plausible or snow (Snow Analytics).
            Without it, rows carry no visitor counts, and sorting by visitors
            returns 400.
        - schema:
            type: string
          in: query
          name: startDate
          required: false
          description: Start of the visitor-count window, YYYY-MM-DD.
        - schema:
            type: string
          in: query
          name: endDate
          required: false
          description: End of the visitor-count window, YYYY-MM-DD.
        - schema:
            type: integer
            minimum: 1
            default: 30
          in: query
          name: days
          required: false
          description: >-
            Days back from today on the team's calendar, converted to
            startDate/endDate. Ignored when startDate or endDate is set.
            Defaults to 30.
        - schema:
            type: string
            enum:
              - mobile
              - desktop
              - both
          in: query
          name: strategy
          required: false
          description: >-
            Which PageSpeed scores to return. Defaults to both, the average of
            mobile and desktop.
        - schema:
            type: string
            enum:
              - asc
              - desc
          in: query
          name: sortDir
          required: false
        - schema:
            type: string
            enum:
              - all
              - included
              - excluded
          in: query
          name: excluded
          required: false
          description: >-
            Pages excluded by crawl rules. Defaults to all, with excluded pages
            flagged.
        - schema:
            type: string
            enum:
              - list
              - full
              - summary
            default: list
          in: query
          name: fields
          required: false
          description: >-
            'full' adds each page's link distribution and crawl metadata.
            Omitted by default: 'summary' returns only the counts, the
            last-audited date, and the PageSpeed tested-page count and last test
            time, without page rows.
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                properties:
                  summary:
                    type: object
                    additionalProperties: true
                    properties:
                      total:
                        type: number
                      auditable:
                        type: number
                      excluded:
                        type: number
                      audited:
                        type: number
                      lastAuditedAt:
                        type: string
                        nullable: true
                      pageSpeedTested:
                        type: number
                      pageSpeedLastTestedAt:
                        type: string
                        nullable: true
                  pages:
                    type: array
                    items:
                      type: object
                      additionalProperties: true
                      properties:
                        id:
                          type: string
                        url:
                          type: string
                        title:
                          type: string
                          nullable: true
                        overallScore:
                          type: number
                          nullable: true
                        techScore:
                          type: number
                          nullable: true
                        contentScore:
                          type: number
                          nullable: true
                        geoScore:
                          type: number
                          nullable: true
                        createdAt:
                          type: string
                          nullable: true
                        updatedAt:
                          type: string
                          nullable: true
                        excluded:
                          type: boolean
                        lastIndexNowSubmittedAt:
                          type: string
                          nullable: true
                        pageSpeedScore:
                          type: number
                          nullable: true
                        linkDistribution:
                          type: object
                          additionalProperties: true
                          nullable: true
                        metadata:
                          type: object
                          additionalProperties: true
                          nullable: true
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Your SnowSEO API key (sk_...).
    apiKey:
      type: apiKey
      name: x-api-key
      in: header

````

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