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

Obtenga datos de identidad, actividad, ingresos y perfil de un visitante específico utilizando el ID de visitante interno devuelto por Flowsery.

Clave API (Bearer token)

Identificacion del visitante

Utilice el ID de visitante interno de los registros Flowsery o las respuestas API. No pase la cookie _fs_vid del navegador directamente como parámetro de ruta.

Campos de respuesta

ParametroTipoDescripcion
identityobjectUbicacion geografica, tipo de dispositivo, navegador, sistema operativo y dimensiones del viewport de la vista de pagina mas reciente
sourcestring | nullFuente de trafico original que trajo a este visitante (dominio de referencia o fuente UTM)
sourceIconUrlstring | nullURL del favicon para la fuente de trafico
activityobjectContadores de visitas y vistas de pagina, informacion de tiempo, ultima URL, objetivos completados y lista de paginas visitadas
revenueobjectResumen de ingresos: totalRevenue, indicador isCustomer, timeToFirstConversion (segundos, o null)
profileobject | nullDatos del usuario identificado (userId, name, email) si se llamo a identify. Null para visitantes anonimos
activityTimelinearrayLista cronologica combinada de todas las vistas de pagina, objetivos completados y pagos de este visitante
Solicitud de ejemplo (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
      }
    ]
  }
}