Skip to main content
GET
Get GA chart data
Get your website analytics from Google Analytics 4. These endpoints power the Traffic dashboard’s Analytics tab when GA4 is your connected provider — users, pageviews, sessions, traffic sources, top pages, and device breakdowns.
You need a Google Analytics 4 integration connected to your team. Connect it from Settings → Integrations → Analytics & Performance. Using PostHog instead? See Analytics (PostHog). Using Plausible? See Analytics (Plausible).

Filters Parameter

The filters query parameter accepts URL-encoded JSON with dimensions and their selected values:
Available dimensions: channel, referrer, campaign, deviceCategory, browser, os, page. Call GET /integrations/ga/filter-values for the available dimension values.

Filter Values

GET /integrations/ga/filter-values Get the available values for a given filter dimension (used to populate filter dropdowns). Pass dimension as a query parameter — one of channel, referrer, campaign, deviceCategory, browser, os, page.

Totals Overview

GET /integrations/ga/traffic/overview Get total users, pageviews, and sessions with period-over-period comparison.

Traffic Chart

GET /integrations/ga/chart/overview Get daily users, pageviews, sessions, and bounce rate for the selected date range — used to power the main trend chart.

Traffic Channels

GET /integrations/ga/channels Get your traffic broken down by source type. Channels returned: Direct, Organic Search, Paid Search, Organic Social, Paid Social, Email, Referral, Display, Organic Video, Affiliates, Unassigned.

Traffic Sources (Referrers)

GET /integrations/ga/sources/overview Get your traffic sources — external referrers and their sessions.

Campaigns

GET /integrations/ga/campaigns/overview Get performance for your UTM-tagged marketing campaigns.

Top Pages

GET /integrations/ga/pages/overview Get your most-viewed pages with engagement metrics.

Traffic by Country

GET /integrations/ga/countries/overview See where your visitors are located geographically.

Traffic by Device

GET /integrations/ga/devices/overview See the device categories your visitors use.

Traffic by Browser

GET /integrations/ga/devices/browsers Break your visitors down by browser.

Traffic by Operating System

GET /integrations/ga/devices/os Break your visitors down by operating system.

New vs Returning Visitors

GET /integrations/ga/user-type See the split between new and returning visitors.

Engagement

GET /integrations/ga/behavior/engagement Get engagement rate with period-over-period comparison.

Average Session Duration

GET /integrations/ga/avg-duration Get the average session duration with period-over-period comparison.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

teamId
string

Team ID

days
integer

Number of days to look back

startDate
string

Start date (YYYY-MM-DD)

endDate
string

End date (YYYY-MM-DD)

country
string

Country filter

filters

Additional dimension filters

Response

Default Response

chartData
object[]
required