API-Referenz

Besucher

Name: Flowsery
Author: Flowsery

Besucheridentität, Aktivität und Umsatzdaten abrufen

GEThttps://analytics.flowsery.com/visitors/{visitorId}

Identitaets-, Aktivitaets-, Umsatz- und Profildaten fuer einen bestimmten Besucher abrufen. Der Besucher wird durch den _fs_vid-Wert im Browser-Cookie identifiziert.

API-Schluessel (Bearer-Token)

Besucheridentifikation

Der Besucher wird durch den <code>_fs_vid</code>-Wert im Browser-Cookie identifiziert. Sie koennen dieses Cookie von Ihren serverseitigen Endpunkten auslesen.

Antwortfelder

Parameter	Typ	Beschreibung
`identity`	`object`	Geografischer Standort, Geraetetyp, Browser, Betriebssystem und Viewport-Abmessungen des letzten Seitenaufrufs
`source`	`string \| null`	Urspruengliche Traffic-Quelle, die diesen Besucher gebracht hat (Referrer-Domain oder UTM-Quelle)
`sourceIconUrl`	`string \| null`	Favicon-URL fuer die Traffic-Quelle
`activity`	`object`	Besuchs- und Seitenaufrufzaehler, Zeitinformationen, letzte URL, abgeschlossene Ziele und Liste besuchter Seiten
`revenue`	`object`	Umsatzuebersicht: totalRevenue, isCustomer-Flag, timeToFirstConversion (Sekunden oder null)
`profile`	`object \| null`	Identifizierte Nutzerdaten (userId, name, email), falls identify aufgerufen wurde. Null fuer anonyme Besucher
`activityTimeline`	`array`	Zusammengefuehrte chronologische Liste aller Seitenaufrufe, Zielabschluesse und Zahlungen fuer diesen Besucher

Beispielanfrage (curl)

curl --request GET \
  --url https://analytics.flowsery.com/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
      }
    ]
  }
}