Besucherdaten abrufen

api-referenceGET

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

Rufen Sie Identitäts-, Aktivitäts-, Umsatz- und Profildaten für einen bestimmten Besucher mithilfe der von Flowsery zurückgegebenen internen Besucher-ID ab.

API-Schluessel (Bearer-Token)

Besucheridentifikation

Verwenden Sie die interne Besucher-ID aus Flowsery Datensätzen oder API Antworten. Übergeben Sie das Browser-Cookie _fs_vid nicht direkt als Routenparameter.

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
      }
    ]
  }
}

{ "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 } ] } }