Plausible Analytics Source Plugin

Latest: v1.0.2

The CloudQuery Plausible plugin extracts information from your Plausible Analytics Stats API (opens in a new tab) and loads it into any supported CloudQuery destination (e.g. PostgreSQL, Snowflake, BigQuery, …).


First you must have a Plausible Analytics (opens in a new tab) account and an API key. You can find your API key in the Plausible Analytics Settings (opens in a new tab).


This example syncs analytics from plausible API to a specified CQ destination. Running the following job on a daily basis will keep your db up to date with the latest events and without duplicates (as long as you use overwrite write mode).

kind: source
# Common source-plugin configuration
  name: plausible
  path: cloudquery/plausible
  version: "v1.0.2"
  tables: ["*"]
  destinations: ["destination"]
  # Plugin specific configuration
    site_id: "YOUR_SITE_ID" # required
    api_key: ${API_KEY} # requried
    period: "30d" # optional

Make sure you use environment variable expansion in production instead of committing the credentials to the configuration file directly.

Plausible Spec

This is the (nested) spec used by this plugin:

  • site_id (string, required):

    This is the value of your domain where plausible is deployed. If you're unsure, navigate to your site settings in Plausible and grab the value of the domain field.

  • api_key (string, required):

    This is your secret API key which you can obtain for your account by going to your user settings page (opens in a new tab).

  • period (string, optional, default: 30d):

    Time period (opens in a new tab) to fetch data.

  • Filters (string, optional, default: null):

    Filter results, see Plausible Analytics Filters (opens in a new tab).

  • metrics (string array, optional, default: ["visitors", "pageviews", "bounce_rate", "visit_duration", "visits"]):

    By default the plugin will sync all metrics.

  • interval (string array, optional, date):

    Choose your reporting interval. Valid options are date (always) and month (when specified period is longer than one calendar month).

  • base_url (string, optional,

    Base URL for the Plausible API. If you are using self-hosted version this should be changed to the domain where plausible is hosted.

Example Queries

Sum all visitors since date

select sum(visitors) from plausible_stats_timeseries where date >= '2021-01-01';

Select all dates where bounce rate was above 50%

select date, bounce_rate from plausible_stats_timeseries where bounce_rate > 50;