Skip to main content
GET
Get Plausible pages
Get your most-viewed pages with visitor, entrance, and exit metrics. search matches the page path and is applied by Plausible before its row cap. See Analytics (Plausible) for the shared filters parameter.

Authorizations

Authorization
string
header
required

Your SnowSEO API key (sk_...).

Query Parameters

teamId
string

Team ID

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
startDate
string

Start date (YYYY-MM-DD)

endDate
string

End date (YYYY-MM-DD)

country
string

Country filter

filters

A JSON object, sent as a string, mapping a dimension to the values to keep, e.g. {"page":["/blog/my-post"],"deviceCategory":["mobile"]}. Dimensions: page, referrer, channel, campaign, deviceCategory, browser, os. Several values for one dimension match any of them; several dimensions must all match. Use values the provider's filter_values tool returns for that dimension; page values are paths without query string or trailing slash. Filter by country with country. Invalid JSON, an unknown dimension or a non-list value returns 400 (code INVALID_FILTERS) naming the supported dimensions.

pageSize
string

Send 'all' for every row; otherwise the provider's top rows are returned. No paging: page is ignored.

Case-insensitive text matched against the page path. Searches every page in the window, not just the default top rows.

Response

200 - application/json

Default Response

pages
object[]