Skip to main content
GET
Get SnowAnalytics traffic chart
Get your website analytics from SnowAnalytics. These endpoints power the Traffic dashboard’s Analytics tab when SnowAnalytics is your connected provider - users, pageviews, sessions, traffic sources, top pages, and device breakdowns.
You need a SnowAnalytics 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). Using Plausible? See Analytics (Plausible).
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.
SnowAnalytics takes one value per dimension, and channel and referrer share one filter. A list with more than one value, or channel and referrer together, returns 400 with code INVALID_FILTERS. Call GET /v3/integrations/snow-analytics/filter-values for the available dimension values.

Traffic Chart

GET /v3/integrations/snow-analytics/chart Get daily visitor, pageview, session, and bounce-rate data for the selected date range. The response also carries totals for the whole range, where visitors are counted once across the period rather than once per day. 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

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
totals
object
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.