Actions7
- Site Actions
- Stats Actions
Overview
The Plausible - Stats: Timeseries node retrieves time series analytics data for a specified website from the Plausible API. It allows users to fetch metrics such as pageviews, visitors, bounce rate, and more, aggregated over customizable periods (e.g., daily, monthly, custom date ranges). This node is useful for automating website analytics reporting, monitoring traffic trends, or integrating Plausible statistics into dashboards and workflows.
Example scenarios:
- Automatically generate weekly reports of website visitors.
- Monitor changes in bounce rate over the last 6 months.
- Integrate real-time traffic trends into business intelligence tools.
Properties
| Name | Type | Meaning |
|---|---|---|
| Site ID | String | Domain of your site in Plausible. Identifies which site's stats to retrieve. |
| Additional Fields | Collection | Optional fields to refine the query. Includes: |
| └ Period | Options | Time period for aggregation (e.g., Day, 30 Days, 7 Days, Month, 6 Months, 12 Months, Custom). |
| └ Date | String | Used with "Custom" period. Two ISO-8601 dates joined by a comma (e.g., 2023-01-01,2023-02-01). |
| └ Metrics | MultiOptions | List of metrics to aggregate (Bounce Rate, Pageviews, Views per Visit, Visit Duration, Visitors, Visits). |
| └ Filters | String | Filter expression to limit results (see Plausible filters documentation). |
Output
The node outputs a JSON object containing the requested time series analytics data. The structure typically includes:
{
"results": [
{
"date": "YYYY-MM-DD",
"visitors": 123,
"pageviews": 456,
// ...other selected metrics
},
// ...more entries per time unit
]
}
- Each entry corresponds to a time unit (e.g., day, month) within the selected period.
- The included metrics depend on what was selected in the input properties.
Dependencies
- External Service: Requires access to the Plausible Analytics API.
- API Key: You must provide valid Plausible API credentials (
plausibleApi) in n8n. - n8n Configuration: The node expects the Plausible domain and optional SSL settings in the credentials.
Troubleshooting
- Invalid Credentials: If the API key or domain is incorrect, you may receive authentication errors. Double-check your Plausible API credentials in n8n.
- Missing Required Property: If "Site ID" is not provided, the node will fail. Ensure this field is filled.
- Incorrect Date Format: When using a custom date range, ensure dates are in ISO-8601 format and separated by a comma (e.g.,
2023-01-01,2023-02-01). - Unsupported Metric/Filter: Using an invalid metric or filter string may result in API errors. Refer to the Plausible API documentation for valid options.