Documentation

Everything you need to integrate privacy-first analytics into your projects.

Installation

Install the Plots CLI to access your analytics from the terminal:

$ npm install -g plots

Once installed, run plots in your terminal to access your dashboard.

Quick Start

Add the tracking script to your website:

HTML
<script defer
  data-domain="yourdomain.com"
  src="https://plots.app/js/script.js">
</script>
ℹ️

Script Size: <1KB

Our tracking script is lightweight and won't impact your page load times. It's smaller than Google Analytics and respects Do Not Track.

Authentication

Sign up for a free account to get your tracking domain:

1

Create an account

Sign up at plots.app/signup

2

Add your domain

Register the domains you want to track

3

Install the script

Copy the tracking code and add it to your site's <head> tag

Web Tracking

Plots automatically tracks page views, but you can also track custom events:

JavaScript
// Track custom events
window.plausible("signup", {
  props: { plan: "starter" }
});

// Track outbound links
window.plausible("Outbound Link: Click", {
  props: { url: "https://example.com" }
});

CLI Usage

View your analytics from the terminal:

View dashboard
$ plots dashboard
Check API key
$ plots auth login
Export data
$ plots export --format csv --output analytics.csv

API Reference

Access your analytics data programmatically:

GET /api/events
curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://plots.app/api/events

Authentication is done via Bearer token in the Authorization header.

Get your API key from your dashboard settings.

Privacy Features

🔒IP Address Hashing

We hash all IP addresses before storing them. Once hashed, the original IP cannot be recovered.

🍪No Cookies

We don't use cookies at all. No cookie banners needed, and you stay GDPR compliant.

🚫Respects Do Not Track

Our script automatically respects the Do Not Track browser setting.

Billing & Plans

Free

$0/mo
  • ✓ 1,000 events/month
  • ✓ Unlimited domains
  • ✓ Basic analytics
  • ✓ 30-day data retention

Starter

$9/mo
  • ✓ 10,000 events/month
  • ✓ Unlimited domains
  • ✓ Advanced analytics
  • ✓ Unlimited data retention
  • ✓ API access
  • ✓ Priority support

Self-Hosting

Plots is open source and can be self-hosted:

Docker
# Run with Docker
docker run -p 3000:3000 plots/analytics

# Or clone and run locally
git clone https://github.com/yourusername/plots
cd plots
bun install
bun dev
⚙️

Requirements

Node.js 18+, Bun 1.0+, ClickHouse 22+

Ready to get started?

Start tracking your analytics in under 5 minutes.

Create Free Account