Actions16
Get Analytics
AI-generatedSummary
Retrieve detailed analytics for a specific short link, including visits, unique visitors, series data, and breakdowns over a defined time range and interval.
Inputs
- Short Link ID (required) — The ID of the short link to fetch analytics for.
- Range (required) — Predefined or custom date range for analytics data. Options include last 7, 30, or 90 days, or a custom range defined by specific start and end dates.
- From — The start date of the custom range. Required if Range is set to Custom.
- To — The end date of the custom range, inclusive. Future dates are clamped to today. Required if Range is set to Custom.
- Interval (required) — The granularity of data points in the returned series: daily, weekly (starting Mondays), or monthly (starting on the 1st).
- All Breakdowns My Plan Allows (required) — Boolean flag to return all breakdown categories your Posty5 plan includes.
- Breakdowns — Specific analytics breakdown categories to retrieve. Only used if All Breakdowns is false.
- Output (required) — Format of the output: either the full API response with totals, series, breakdowns and meta, or flattened series data as individual items each with meta.
- Options — Additional parameters such as the number of rows per breakdown and the IANA Time Zone used for date calculations.
Output shape
a single item containing analytics data including totals, series, breakdowns, and meta information; or multiple items representing individual series points if 'Series as Items' output format is selected.
The time range respects the specified time zone or falls back to the workflow time zone or UTC. Selecting a range or breakdowns outside your plan results in a plan error. Custom ranges require valid From and To dates. Output format affects the shape of returned data: full response is one item, 'Series as Items' returns one item per series point.
Examples
Example 1: Get last 30 days daily analytics for a short link
Set 'Short Link ID' to the target link's ID, 'Range' to 'Last 30 Days', 'Interval' to 'Day', and leave other options as default.
Example 2: Get custom date range monthly analytics with selected breakdowns
Set 'Short Link ID', choose 'Range' as 'Custom', specify 'From' and 'To' dates, set 'Interval' to 'Month', turn off 'All Breakdowns', and select desired breakdown categories.