---
title: "Browse a site's pages as a folder tree"
method: GET
path: "/v3/pages/folders"
tags: ["Pages"]
---

# Browse a site's pages as a folder tree

`GET /v3/pages/folders`

Groups the team's pages into the direct children of a path: the sub-folders below it with their traffic rolled up, and the pages that sit at that level. Call it with no path for the site root, then walk down using the path of any returned folder.

## Query parameters

- `teamId` string
- `startDate` string
- `endDate` string
- `days` integer
- `country` string
- `device` string
- `type` string
- `path` string

## Response `200`

Default Response

- object
  - `path` string, required
  - `breadcrumb` object[]
    - `path` string
    - `name` string
  - `folders` object[], required
    - `pages` integer
    - `clicks` number
    - `impressions` number
    - `ctr` number
    - `position` number
    - `keywords` integer
    - `keywordsChange` number
    - `auditScore` integer, nullable
    - `auditedPages` integer
    - `clicksChange` number
    - `impressionsChange` number
    - `ctrChange` number
    - `positionChange` number
    - `path` string, required
    - `name` string, required
    - `url` string, required
    - `subfolders` integer
    - `topPages` object[]
      - `url` string, required
      - `path` string, required
      - `title` string, nullable
      - `statusCode` integer, nullable
      - `clicks` number
      - `impressions` number
      - `ctr` number
      - `position` number
      - `keywords` integer
      - `keywordsChange` number
      - `clicksChange` number
      - `impressionsChange` number
      - `ctrChange` number
      - `positionChange` number
      - `auditScore` integer, nullable
      - `indexVerdict` string, nullable
      - `aiCitations` integer
    - `childFolders` object[]
      - `pages` integer
      - `clicks` number
      - `impressions` number
      - `ctr` number
      - `position` number
      - `keywords` integer
      - `keywordsChange` number
      - `auditScore` integer, nullable
      - `auditedPages` integer
      - `clicksChange` number
      - `impressionsChange` number
      - `ctrChange` number
      - `positionChange` number
      - `path` string, required
      - `name` string, required
      - `url` string, required
      - `subfolders` integer
      - `topPages` object[]
        - `url` string, required
        - `path` string, required
        - `title` string, nullable
        - `statusCode` integer, nullable
        - `clicks` number
        - `impressions` number
        - `ctr` number
        - `position` number
        - `keywords` integer
        - `keywordsChange` number
        - `clicksChange` number
        - `impressionsChange` number
        - `ctrChange` number
        - `positionChange` number
        - `auditScore` integer, nullable
        - `indexVerdict` string, nullable
        - `aiCitations` integer
      - `childFolders` object[]
        - `pages` integer
        - `clicks` number
        - `impressions` number
        - `ctr` number
        - `position` number
        - `keywords` integer
        - `keywordsChange` number
        - `auditScore` integer, nullable
        - `auditedPages` integer
        - `clicksChange` number
        - `impressionsChange` number
        - `ctrChange` number
        - `positionChange` number
        - `path` string, required
        - `name` string, required
        - `url` string, required
        - `subfolders` integer
        - `topPages` object[]
          - `url` string, required
          - `path` string, required
          - `title` string, nullable
          - `statusCode` integer, nullable
          - `clicks` number
          - `impressions` number
          - `ctr` number
          - `position` number
          - `keywords` integer
          - `keywordsChange` number
          - `clicksChange` number
          - `impressionsChange` number
          - `ctrChange` number
          - `positionChange` number
          - `auditScore` integer, nullable
          - `indexVerdict` string, nullable
          - `aiCitations` integer
  - `pages` object[], required
    - `url` string, required
    - `path` string, required
    - `title` string, nullable
    - `statusCode` integer, nullable
    - `clicks` number
    - `impressions` number
    - `ctr` number
    - `position` number
    - `keywords` integer
    - `keywordsChange` number
    - `clicksChange` number
    - `impressionsChange` number
    - `ctrChange` number
    - `positionChange` number
    - `auditScore` integer, nullable
    - `indexVerdict` string, nullable
    - `aiCitations` integer
  - `pagesTotals` object
    - `pages` integer
    - `clicks` number
    - `impressions` number
    - `ctr` number
    - `position` number
    - `keywords` integer
    - `keywordsChange` number
    - `auditScore` integer, nullable
    - `auditedPages` integer
    - `clicksChange` number
    - `impressionsChange` number
    - `ctrChange` number
    - `positionChange` number
  - `totals` object
    - `pages` integer
    - `clicks` number
    - `impressions` number
    - `ctr` number
    - `position` number
    - `keywords` integer
    - `keywordsChange` number
    - `auditScore` integer, nullable
    - `auditedPages` integer
    - `clicksChange` number
    - `impressionsChange` number
    - `ctrChange` number
    - `positionChange` number
  - `series` object[]
    - `date` string
    - `clicks` number
    - `impressions` number
    - `position` number
  - `connected` boolean
  - `startDate` string, nullable
  - `endDate` string, nullable

## Changes

- **2026-09-01** `dd05cfe959f3` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/snowseo/apis/snowseo-api/changes/v3/pages/folders/get.md)

---

[API](https://skmtc.dev/snowseo/apis/snowseo-api.md) · [All operations](https://skmtc.dev/snowseo/apis/snowseo-api/llms.txt) · [OpenAPI document](https://skmtc.dev/snowseo/apis/snowseo-api/revisions/443005424e10?raw)