api-referenceGET
GEThttps://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. Geef websiteId 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

ParameterTypeBeschrijving
websiteIdstringWebsite-ID om te gebruiken met een werkruimte-API-token. Laat weg als je authenticeert met een website-API-sleutel.
domainstringWebsitedomein 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

ParameterTypeBeschrijving
identityobjectGeografische locatie, apparaattype, browser, besturingssysteem en viewportafmetingen van de meest recente paginaweergave
sourcestring | nullOorspronkelijke verkeersbron die deze bezoeker bracht (verwijzend domein of UTM-bron)
sourceIconUrlstring | nullFavicon-URL van de verkeersbron
activityobjectAantal bezoeken en paginaweergaven, tijdsinformatie, laatste URL, voltooide goals en lijst met bezochte pagina's
revenueobjectOmzetoverzicht: totalRevenue, isCustomer-vlag, timeToFirstConversion (seconden, of null)
profileobject | nullGegevens van de geïdentificeerde gebruiker (userId, name, email) als identify is aangeroepen. Null voor anonieme bezoekers
activityTimelinearraySamengevoegde 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
      }
    ]
  }
}