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

Récupérez les données d'identité, d'activité, de revenus et de profil d'un visiteur spécifique à l'aide de l'ID visiteur interne renvoyé par Flowsery.

Cle API (Bearer token)

Identification du visiteur

Utilisez l'ID visiteur interne des enregistrements Flowsery ou des réponses API. Ne transmettez pas le cookie _fs_vid du navigateur directement comme paramètre de route.

Champs de reponse

ParametreTypeDescription
identityobjectLocalisation geographique, type d'appareil, navigateur, systeme d'exploitation et dimensions du viewport de la derniere page vue
sourcestring | nullSource de trafic originale qui a amene ce visiteur (domaine referent ou source UTM)
sourceIconUrlstring | nullURL du favicon de la source de trafic
activityobjectNombre de visites et de pages vues, informations de temps, derniere URL, objectifs atteints et liste des pages visitees
revenueobjectResume des revenus : totalRevenue, indicateur isCustomer, timeToFirstConversion (secondes, ou null)
profileobject | nullDonnees utilisateur identifiees (userId, name, email) si identify a ete appele. Null pour les visiteurs anonymes
activityTimelinearrayListe chronologique fusionnee de toutes les pages vues, objectifs atteints et paiements pour ce visiteur
Exemple de requete (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
      }
    ]
  }
}