List all sites in your Plausible account

Get detailed analytics breakdown for a site.

COMMON QUERIES:

1. Most visited pages in last 7 days: {"site_id": "example.com", "metrics": ["visitors", "pageviews"], "dimensions": ["event:page"], "date_range": "7d"}

2. Traffic sources with bounce rates: {"site_id": "example.com", "metrics": ["visitors", "bounce_rate"], "dimensions": ["visit:source"], "date_range": "30d"}

3. Geographic breakdown: {"site_id": "example.com", "metrics": ["visitors", "visit_duration"], "dimensions": ["visit:country", "visit:city"], "date_range": "month"}

4. Hourly visitor trends for today: {"site_id": "example.com", "metrics": ["visitors", "pageviews"], "dimensions": ["time:hour"], "date_range": "day"}

5. Device and browser analysis: {"site_id": "example.com", "metrics": ["visitors", "bounce_rate"], "dimensions": ["visit:device", "visit:browser"], "date_range": "7d"}

6. Campaign performance: {"site_id": "example.com", "metrics": ["visitors", "views_per_visit"], "dimensions": ["visit:utm_campaign", "visit:utm_source"], "date_range": "month"}

AVAILABLE METRICS:

• visitors: Number of unique visitors

• visits: Number of visits/sessions

• pageviews: Number of pageview events

• views_per_visit: Average number of pages viewed per visit

• bounce_rate: Percentage of visits with only one page view

• visit_duration: Average visit duration in seconds

• events: Total number of events (pageviews + custom events)

AVAILABLE DIMENSIONS: Event dimensions (page/content related):

• event:name - Event name (e.g., 'pageview', 'download', etc.)

• event:page - Full page URL including UTM parameters

• event:page.pathname - Page path without query parameters

• event:props:* - Custom event properties (e.g., event:props:author)

Visit dimensions (visitor/session related):

• visit:source - Traffic source (e.g., 'Google', 'Twitter')

• visit:referrer - Full referrer URL

• visit:utm_medium - Marketing medium (e.g., 'cpc', 'social')

• visit:utm_source - UTM source parameter

• visit:utm_campaign - UTM campaign name

• visit:utm_content - UTM content parameter

• visit:utm_term - UTM term parameter

• visit:device - Device type (desktop, mobile, tablet)

• visit:browser - Browser name

• visit:browser_version - Browser version

• visit:os - Operating system

• visit:os_version - OS version

• visit:country - Country of visitor

• visit:country_name - Full country name

• visit:region - Region/state of visitor

• visit:region_name - Full region/state name

• visit:city - City of visitor

• visit:city_name - Full city name

Time dimensions (for trends and patterns):

• time:minute - Group by minute (only available with 'day' time:day range)

• time:hour - Group by hour (only available with 'day' time:day range)

• time:day - Group by day (available with any time:day range)

• time:week - Group by week (available with 'month', '6mo', '12mo', or custom ranges)

• time:month - Group by month (available with '6mo', '12mo', or custom ranges)

Note: Time dimensions are mutually exclusive - only one can be used at a time. When using time dimensions, results are automatically sorted chronologically.

FILTERING EXAMPLES:

1. Only Chrome users: {"filters": [["is", "visit:browser", ["Chrome"]]]}

2. Blog pages only: {"filters": [["contains", "event:page", ["/blog"]]]}

3. Multiple countries: {"filters": [["is", "visit:country", ["US", "GB", "CA"]]]}

4. Exclude certain pages: {"filters": [["is_not", "event:page", ["/admin", "/login"]]]}

5. Complex filter (Chrome users from US): {"filters": [["and", [["is", "visit:browser", ["Chrome"]], ["is", "visit:country", ["US"]]]]]}

Get detailed analytics for a specific page

Get traffic analytics for a site using structured parameters