API Reference

Time Series

Name: Flowsery
Author: Flowsery

Retrieve time series analytics data

GEThttps://analytics.flowsery.com/timeseries

Fetch time series analytics data grouped by hour, day, week, or month.

Bearer Token (API key)

Optional parameters

Parameter	Type	Description
`interval`	`string`	Aggregation interval. Accepted values: hour, day, week, month.
`startAt`	`string`	ISO 8601 start date/time. Defaults vary by interval (hour: last 24h, day/week: last 30 days, month: last 12 months).
`endAt`	`string`	ISO 8601 end date/time. Must accompany startAt.
`timezone`	`string`	Timezone for aggregation (e.g., UTC, America/New_York). Falls back to the site's configured timezone.
`limit`	`number`	Maximum rows to return (1-1000, default: 100).
`offset`	`number`	Number of rows to skip for pagination (min 0, default: 0).

Filter parameters

Parameter	Type	Description
`filter_country`	`string`	Country name or code (e.g., filter_country=United States,Canada).
`filter_region`	`string`	Region or state.
`filter_city`	`string`	City name.
`filter_device`	`string`	Device type (desktop, mobile, tablet).
`filter_browser`	`string`	Browser name (Chrome, Safari, Firefox, Edge). Safari includes Mobile Safari automatically.
`filter_os`	`string`	Operating system (Mac OS, Windows, iOS, Android).
`filter_referrer`	`string`	Referrer domain or well-known referrer name.
`filter_ref`	`string`	The ref URL parameter value.
`filter_source`	`string`	The source URL parameter value.
`filter_via`	`string`	The via URL parameter value.
`filter_utm_source`	`string`	UTM source.
`filter_utm_medium`	`string`	UTM medium.
`filter_utm_campaign`	`string`	UTM campaign.
`filter_utm_term`	`string`	UTM term.
`filter_utm_content`	`string`	UTM content.
`filter_page`	`string`	Page path or URL.
`filter_entry_page`	`string`	Entry page path or URL.
`filter_hostname`	`string`	Hostname/domain.
`filter_channel`	`string`	Marketing channel.
`filter_goal`	`string`	Goal name.

Notes

Same-day queries are automatically upgraded to hourly granularity. The revenue field always includes a revenueBreakdown object with new, renewal, and refund amounts. Conversion rate is revenue-based, calculated as revenue / unique visitors. All timestamps follow ISO 8601 format.