Skip to main content
GET
Get Plausible traffic chart
Get your website analytics from Plausible. These endpoints power the Traffic dashboard’s Analytics tab when Plausible is your connected provider - users, pageviews, sessions, traffic sources, top pages, and device breakdowns.
You need a Plausible integration connected to your team. Connect it from Settings → Integrations → Analytics & Performance. Using Google Analytics 4 instead? See Analytics (Google Analytics 4). Using PostHog? See Analytics (PostHog).
These routes require an active plan; without one they return 403. Pass startDate and endDate or days; see Date Windows.

Filters Parameter

The filters query parameter accepts URL-encoded JSON: an object keyed by dimension, each with a list of selected values. Dimensions: page, referrer, channel, campaign, deviceCategory, browser, os. Invalid JSON, an unknown dimension, or a value that is not a list returns 400 with code INVALID_FILTERS naming the supported dimensions.
Call GET /v3/integrations/plausible/filter-values for the available dimension values.

Traffic Chart

GET /v3/integrations/plausible/chart Get daily visitor, pageview, session, and bounce-rate data for the selected date range. incompleteFrom is today in the site’s time zone; days from it onward are still being collected.

Authorizations

Authorization
string
header
required

Your SnowSEO API key (sk_...).

Query Parameters

teamId
string
required

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.

Response

200 - application/json

Default Response

chartData
object[]
required
incompleteFrom
string | null

Today on the provider's own calendar (YYYY-MM-DD). Days from here on are still being collected. Null when the provider's time zone is unknown.