api-referenceGET
GET
https://analytics.flowsery.com/analytics/api/v1/visitors/{visitorId}Haal identiteit, activiteit, omzet en profielgegevens op van een specifieke bezoeker met de interne visitorId die Flowsery teruggeeft.
Bearer-token (werkruimtetoken of website-API-sleutel)
Werkruimtetokens hebben een websiteselector nodig
Werkruimte-API-tokens hebben toegang tot elke website in de werkruimte. GeefwebsiteId of domain mee, zodat Flowsery weet welke website je wilt opvragen of wijzigen. Website-API-sleutels horen al bij één website, dus daar kun je de selector weglaten.Websiteselector
| Parameter | Type | Beschrijving |
|---|---|---|
websiteId | string | Website-ID om te gebruiken met een werkruimte-API-token. Laat weg als je authenticeert met een website-API-sleutel. |
domain | string | Websitedomein om te gebruiken met een werkruimte-API-token als er geen websiteId is opgegeven. Laat weg als je authenticeert met een website-API-sleutel. |
Bezoekersidentificatie
Gebruik de interne visitorId uit Flowsery-records of API-antwoorden. Geef de browsercookie _fs_vid niet rechtstreeks mee als routeparameter.Velden in het antwoord
| Parameter | Type | Beschrijving |
|---|---|---|
identity | object | Geografische locatie, apparaattype, browser, besturingssysteem en viewportafmetingen van de meest recente paginaweergave |
source | string | null | Oorspronkelijke verkeersbron die deze bezoeker bracht (verwijzend domein of UTM-bron) |
sourceIconUrl | string | null | Favicon-URL van de verkeersbron |
activity | object | Aantal bezoeken en paginaweergaven, tijdsinformatie, laatste URL, voltooide goals en lijst met bezochte pagina's |
revenue | object | Omzetoverzicht: totalRevenue, isCustomer-vlag, timeToFirstConversion (seconden, of null) |
profile | object | null | Gegevens van de geïdentificeerde gebruiker (userId, name, email) als identify is aangeroepen. Null voor anonieme bezoekers |
activityTimeline | array | Samengevoegde chronologische lijst van alle paginaweergaven, voltooide goals en betalingen van deze bezoeker |
Voorbeeldverzoek (curl)
curl --request GET \
--url https://analytics.flowsery.com/analytics/api/v1/visitors/{visitorId} \
--header 'Authorization: Bearer <api-key>'200
{
"status": "success",
"data": {
"visitorId": "a3ab2331-989f-4cfa-91c6-2461c9e3c6bd",
"identity": {
"country": "South Korea",
"countryCode": "KR",
"region": "KR-44",
"city": "Seosan City",
"browser": { "name": "Chrome", "version": "133.0.0.0" },
"os": { "name": "Mac OS", "version": "10.15.7" },
"device": { "type": "Desktop" },
"viewport": { "width": 1728, "height": 998 }
},
"source": "youtube.com",
"sourceIconUrl": "https://icons.duckduckgo.com/ip3/youtube.com.ico",
"activity": {
"visitCount": 3,
"pageViewCount": 8,
"firstVisitAt": "2025-04-11T03:38:49.154Z",
"lastVisitAt": "2025-04-11T03:38:49.154Z",
"currentUrl": "example.com/",
"visitedPages": [
{ "url": "example.com/", "timestamp": "2025-04-11T03:38:49.154Z" }
],
"completedCustomGoals": [
{ "name": "newsletter_signup", "timestamp": "2025-04-11T03:38:54.253Z" }
]
},
"revenue": {
"totalRevenue": 29.99,
"isCustomer": true,
"timeToFirstConversion": 3600
},
"profile": {
"userId": "usr_123",
"name": "John Doe",
"email": "john@example.com"
},
"activityTimeline": [
{
"type": "payment",
"timestamp": "2025-04-11T04:38:49.154Z",
"url": null,
"eventName": null,
"amount": 29.99
},
{
"type": "goal",
"timestamp": "2025-04-11T03:38:54.253Z",
"url": null,
"eventName": "newsletter_signup",
"amount": null
},
{
"type": "pageview",
"timestamp": "2025-04-11T03:38:49.154Z",
"url": "example.com/",
"eventName": null,
"amount": null
}
]
}
}