Skip to main content
POST
cURL
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).

Filters Parameter

The filters query parameter accepts URL-encoded JSON with dimensions and their selected values:
Call GET /integrations/plausible/filter-values for the available dimension values.

Filter Values

GET /integrations/plausible/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.

Page Counts

GET /integrations/plausible/analytics Get page-level visitor counts across your site.

Traffic Chart

GET /integrations/plausible/chart Get daily visitor, pageview, session, and bounce-rate data for the selected date range.

Top Pages

GET /integrations/plausible/pages Get your most-viewed pages with visitor, entrance, and exit metrics.

Traffic Sources

GET /integrations/plausible/sources Get your traffic sources — external referrers and their sessions and users.

Traffic Channels

GET /integrations/plausible/channels Get your traffic grouped into canonical channels (Direct, Organic Search, Referral, and more) with period-over-period change.

Traffic by Country

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

Traffic by Device

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

Traffic by Browser

GET /integrations/plausible/browsers Break your visitors down by browser.

Traffic by Operating System

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

Campaigns

GET /integrations/plausible/campaigns Get performance for your UTM-tagged marketing campaigns — sessions, visitors, bounce rate, and average duration.

Average Session Duration

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

New vs Returning Visitors

GET /integrations/plausible/user-type See the split between new and returning visitors with period-over-period change.

Authorizations

Authorization
string
header
required

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

Response

200

Default Response