API Reference
Visitor
Retrieve visitor identity, activity, and revenue data
GET
https://analytics.flowsery.com/visitors/{visitorId}Fetch identity, activity, revenue, and profile data for a specific visitor. The visitor is identified by the _fs_vid value stored in the browser cookie.
Bearer Token (API key)
Visitor identification
The visitor is identified by the <code>_fs_vid</code> value stored in the browser cookie. You can read this cookie from your server-side endpoints.Response fields
| Parameter | Type | Description |
|---|---|---|
identity | object | Geographic location, device type, browser, OS, and viewport dimensions from the most recent pageview |
source | string | null | Original traffic source that brought this visitor (referrer domain or UTM source) |
sourceIconUrl | string | null | Favicon URL for the traffic source |
activity | object | Visit and pageview counts, timing info, last URL, completed goals, and visited pages list |
revenue | object | Revenue summary: totalRevenue, isCustomer flag, timeToFirstConversion (seconds, or null) |
profile | object | null | Identified user data (userId, name, email) if identify was called. Null for anonymous visitors |
activityTimeline | array | Merged chronological list of all pageviews, goal completions, and payments for this visitor |