api-referenceGET
GEThttps://analytics.flowsery.com/analytics/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.

Token Bearer (token de workspace o clave API de sitio web)

Los tokens de espacio de trabajo necesitan un selector de sitio web

Los tokens de API del espacio de trabajo pueden acceder a todos los sitios web del espacio de trabajo. Pase websiteId o domain para que Flowsery sepa qué sitio web consultar o mutar. Las claves API del sitio web ya están destinadas a un sitio web, por lo que se puede omitir el selector.

Selector de sitios web

ParámetroTipoDescripción
websiteIdstringID del sitio web para usar con un token de API del espacio de trabajo. Omitir al autenticarse con una clave API de sitio web.
domainstringSitio web domain para usar con un token API de espacio de trabajo cuando no se proporciona websiteId. Omitir al autenticarse con una clave API de sitio web.

Identificación 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

ParámetroTipoDescripción
identityobjectUbicación geográfica, tipo de dispositivo, navegador, sistema operativo y dimensiones del viewport de la vista de página más reciente
sourcestring | nullFuente de tráfico original que trajo a este visitante (dominio de referencia o fuente UTM)
sourceIconUrlstring | nullURL del favicon para la fuente de tráfico
activityobjectContadores de visitas y vistas de página, información de tiempo, última URL, objetivos completados y lista de páginas visitadas
revenueobjectResumen de ingresos: totalRevenue, indicador isCustomer, timeToFirstConversion (segundos, o null)
profileobject | nullDatos del usuario identificado (userId, name, email) si se llamó a identify. Null para visitantes anónimos
activityTimelinearrayLista cronológica combinada de todas las vistas de página, objetivos completados y pagos de este visitante
Solicitud de ejemplo (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
      }
    ]
  }
}