Skip to main content
GET
List crawled pages for a site
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). 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.

Authorizations

Authorization
string
header
required

Your SnowSEO API key (sk_...).

Query Parameters

teamId
string
required

SnowSEO team ID, as returned by list_teams.

page
integer

1-based page. Default 1.

pageSize
string

Rows per page (max 1000), or 'all'. Every response reports total and totalPages.

Matches the page URL or title.

sortBy
enum<string>
Available options:
page,
url,
visitors,
indexingVerdict,
technical,
content,
geo,
pageSpeed,
lastAuditedAt,
performance,
accessibility,
bestPractices,
seo,
fetchedAt,
lastIndexNowSubmittedAt
omitUrls
string[]

Pages to leave out. Repeat for several URLs.

issueIds
string[]

Only pages where any of these catalogue issues is unresolved in the latest audit.

analyticsProvider
enum<string>

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.

Available options:
ga,
posthog,
plausible,
snow
startDate
string

Start of the visitor-count window, YYYY-MM-DD.

endDate
string

End of the visitor-count window, YYYY-MM-DD.

days
integer
default:30

Days back from today on the team's calendar, converted to startDate/endDate. Ignored when startDate or endDate is set. Defaults to 30.

Required range: x >= 1
strategy
enum<string>

Which PageSpeed scores to return. Defaults to both, the average of mobile and desktop.

Available options:
mobile,
desktop,
both
sortDir
enum<string>
Available options:
asc,
desc
excluded
enum<string>

Pages excluded by crawl rules. Defaults to all, with excluded pages flagged.

Available options:
all,
included,
excluded
fields
enum<string>
default:list

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

Available options:
list,
full,
summary

Response

200 - application/json

Default Response

summary
object
pages
object[]