API Reference
Overview
Retrieve aggregate analytics metrics
GET
https://analytics.flowsery.com/overviewFetch aggregated analytics metrics for your website.
Bearer Token (API key)
Query parameters
| Parameter | Type | Description |
|---|---|---|
startAt | string | Start date in ISO 8601 format. |
endAt | string | End date in ISO 8601 format. |
timezone | string | IANA timezone identifier. 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
Returns all-time aggregated data by default when no date range is specified. Supplying only one of startAt or endAt will result in a 400 error. Conversion rate is expressed as a percentage (e.g., 1.15 means 1.15%).