Reports & Exports - Plausible Analytics

Plausible provides flexible reporting and data export options to help you share insights, analyze trends, and integrate analytics data with other tools.

Export Formats

Export your analytics data in multiple formats:

CSV Export

Download any dashboard view as CSV for spreadsheet analysis

Stats API

Programmatic access to all metrics and breakdowns

Email Reports

Scheduled reports delivered to your inbox

Shared Links

Public or password-protected dashboard access

CSV Exports

Download your analytics data for offline analysis:

Exporting Data

Configure Your View

Set up the dashboard view you want to export:

Select date range
Apply filters
Choose metrics
Apply segments

Click Export

Click the “Export” or “Download CSV” button in your dashboard.

Choose Data

Select what to export:

Top pages
Traffic sources
Geographic data
Device statistics
Goal conversions
Custom breakdowns

Download File

Your CSV file downloads immediately, ready for use in:

Excel or Google Sheets
Data analysis tools
Business intelligence platforms
Custom reporting systems

CSV Data Structure

Exported files include:

date,visitors,pageviews,bounce_rate,visit_duration
2024-03-01,1523,4891,42.5,156
2024-03-02,1687,5234,39.8,168
2024-03-03,1456,4567,45.2,142

CSV exports respect all applied filters and date ranges, giving you exactly the data you see on your dashboard.

What You Can Export

Aggregate Metrics:

Visitors, visits, pageviews
Bounce rate, visit duration
Views per visit
Conversion rates
Revenue metrics (Business plan)

Breakdown Data:

Top pages with metrics
Traffic sources with conversion data
Geographic breakdown (country, city, region)
Device, browser, OS statistics
Entry and exit pages
UTM campaign performance

Time Series:

Daily, weekly, or monthly trends
Hour-by-hour data for shorter ranges
Historical comparisons

Email Reports

Receive automated analytics summaries via email:

Report Types

Weekly Reports

Every Monday, receive a summary of the previous week:

Total visitors
Pageviews
Top pages
Top sources
Comparison with previous week

Monthly Reports

First day of each month, get the previous month’s performance:

Monthly visitor trends
Best performing content
Traffic source breakdown
Month-over-month comparison

Configuring Email Reports

Go to Site Settings

Navigate to your site settings page.

Email Reports Section

Find the “Email Reports” or “Weekly/Monthly Reports” section.

Enable Reports

Toggle on the reports you want:

Weekly report
Monthly report
Both

Add Recipients

Enter email addresses for report recipients (team members or stakeholders).

Email Report Content

Reports include: Summary Metrics:

Unique visitors
Total pageviews
Bounce rate
Visit duration
Percentage change from previous period

Top Performers:

Most visited pages (top 5)
Best traffic sources (top 5)
Top countries (top 3)

Visual Elements:

Traffic trend graph
Key metric comparisons
Up/down indicators

Email reports are sent to all configured recipients. Team members can opt out individually from their user preferences.

Shared Links

Create shareable dashboard links for stakeholders:

Creating Shared Links

Navigate to Shared Links

Go to Site Settings → Shared Links.

Create New Link

Click “New Link” to create a shared dashboard:

Name: Descriptive name for the link
Password: Optional password protection
Segment: Apply a segment filter (optional)

Copy Link

Copy the generated URL and share with:

Clients
Team members without accounts
Stakeholders
Partners

Shared Link Options

Public Links:

No password required
Anyone with the URL can view
Useful for transparent reporting
Can be indexed by search engines if not careful

Password Protected:

Require password to access
Additional security layer
Share password separately
Suitable for sensitive data

Segment Filtering:

Apply saved segment to shared view
Limit what data is visible
Create focused reports for specific stakeholders

Shared links provide read-only access to your analytics. Recipients cannot modify settings, but they can see all data within the shared view.

Managing Shared Links

Edit: Change name, password, or segment
Revoke: Disable link immediately
Regenerate: Create new URL if compromised
Track Usage: See when links were last accessed

Stats API

Programmatic access to all your analytics data:

API Capabilities

The Stats API provides:

Aggregate Metrics: Get overall statistics for any period
Time Series: Retrieve trends over time
Breakdowns: Drill down by any dimension
Real-time: Access current visitor data
Custom Queries: Combine filters, metrics, and dimensions

Example API Calls

Get aggregate stats:

curl https://plausible.io/api/v2/query \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "site_id": "yourdomain.com",
    "metrics": ["visitors", "pageviews", "bounce_rate"],
    "date_range": ["2024-03-01", "2024-03-31"]
  }'

Get breakdown by source:

curl https://plausible.io/api/v2/query \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "site_id": "yourdomain.com",
    "metrics": ["visitors", "visits"],
    "date_range": "last_30_days",
    "dimensions": ["visit:source"]
  }'

The Stats API uses your same analytics data with no sampling. Perfect for building custom dashboards, integrations, or automated reporting.

API Authentication

Secure your API access:

Generate API key in account settings
Include in Authorization header
Keep key secure (never commit to code)
Rotate keys periodically

Rate Limits

API requests are rate-limited:

Standard: 600 requests per hour
Spike tolerance: Short bursts allowed
429 errors: Wait before retrying

Custom Reporting Solutions

Build custom reports using Plausible data:

Data Warehouse Integration

Export data to your data warehouse:

Schedule API Calls

Set up automated scripts to fetch data daily/weekly.

Transform Data

Process API responses into your warehouse schema.

Join with Other Data

Combine Plausible analytics with:

CRM data
Sales information
Product metrics
Customer data

Create Reports

Build comprehensive reports across all your data sources.

Business Intelligence Tools

Connect Plausible to BI platforms:

Google Data Studio: Create custom dashboards
Tableau: Build visual analytics
Power BI: Enterprise reporting
Metabase: Open-source analytics

Automated Alerts

Build alert systems:

# Example: Alert on traffic drop
import requests

response = requests.post(
    'https://plausible.io/api/v2/query',
    headers={'Authorization': 'Bearer YOUR_KEY'},
    json={
        'site_id': 'yourdomain.com',
        'metrics': ['visitors'],
        'date_range': 'day',
        'compare': 'previous_period'
    }
)

data = response.json()
if data['results'][0]['change'] < -20:  # 20% drop
    send_alert('Traffic dropped significantly!')

Report Best Practices

Regular Cadence

Establish consistent reporting schedule (weekly or monthly).

Relevant Metrics

Focus on metrics that matter to your stakeholders.

Context Matters

Include comparison periods and explain changes.

Secure Sharing

Use password protection for sensitive data.

Data Ownership

Your data belongs to you:

Export Anytime: Download all your data whenever needed
No Lock-in: Full data portability
API Access: Programmatic access to all metrics
Data Deletion: Request complete data removal

Privacy in Reports

Reporting respects privacy:

No personal data exposed in exports
Aggregated statistics only
No individual visitor tracking
GDPR-compliant data handling

Advanced Export Options

Filtered Exports

Export specific subsets:

Apply filters before exporting
Use segments for consistent exports
Combine multiple filters
Save export configurations

Comparison Exports

Include comparison data:

Period-over-period changes
Year-over-year trends
Percentage changes
Absolute differences

Scheduled Exports

Automate data exports:

Use API with cron jobs
Schedule daily/weekly exports
Store in cloud storage
Feed into other systems

Troubleshooting

CSV export incomplete

Large exports may be truncated
Use API for complete data sets
Split exports by date range
Contact support for very large exports

Email reports not arriving

Check spam folder
Verify email address is correct
Confirm reports are enabled
Check team member preferences

Shared link not working

Verify link hasn’t been revoked
Check password if protected
Clear browser cache
Try incognito/private mode

API rate limit errors

Reduce request frequency
Implement exponential backoff
Cache responses when appropriate
Contact support for higher limits

Next Steps

Stats API Documentation

Explore the full API capabilities

Dashboard

View your analytics dashboard

Getting Started

Core Features

Integration

Self-Hosting

Advanced

​Export Formats

CSV Export

Stats API

Email Reports

Shared Links

​CSV Exports

​Exporting Data

​CSV Data Structure

​What You Can Export

​Email Reports

​Report Types

​Configuring Email Reports

​Email Report Content

​Shared Links

​Creating Shared Links

​Shared Link Options

​Managing Shared Links

​Stats API

​API Capabilities

​Example API Calls

​API Authentication

​Rate Limits

​Custom Reporting Solutions

​Data Warehouse Integration

​Business Intelligence Tools

​Automated Alerts

​Report Best Practices

Regular Cadence

Relevant Metrics

Context Matters

Secure Sharing

​Data Ownership

​Privacy in Reports

​Advanced Export Options

​Filtered Exports

​Comparison Exports

​Scheduled Exports

​Troubleshooting

​Next Steps

Stats API Documentation

Dashboard

Build docs developers (and LLMs) love

Export Formats

CSV Exports

Exporting Data

CSV Data Structure

What You Can Export

Email Reports

Report Types

Configuring Email Reports

Email Report Content

Shared Links

Creating Shared Links

Shared Link Options

Managing Shared Links

Stats API

API Capabilities

Example API Calls

API Authentication

Rate Limits

Custom Reporting Solutions

Data Warehouse Integration

Business Intelligence Tools

Automated Alerts

Report Best Practices

Data Ownership

Privacy in Reports

Advanced Export Options

Filtered Exports

Comparison Exports

Scheduled Exports

Troubleshooting

Next Steps