Obtener datos del visitante

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 <code>websiteId</code> o <code>domain</code> 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

Parametro	Tipo	Descripcion
`websiteId`	`string`	ID del sitio web para usar con un token de API del espacio de trabajo. Omitir al autenticarse con una clave API de sitio web.
`domain`	`string`	Sitio 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.

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

Parametro	Tipo	Descripcion
`identity`	`object`	Ubicacion geografica, tipo de dispositivo, navegador, sistema operativo y dimensiones del viewport de la vista de pagina mas reciente
`source`	`string \| null`	Fuente de trafico original que trajo a este visitante (dominio de referencia o fuente UTM)
`sourceIconUrl`	`string \| null`	URL del favicon para la fuente de trafico
`activity`	`object`	Contadores de visitas y vistas de pagina, informacion de tiempo, ultima URL, objetivos completados y lista de paginas visitadas
`revenue`	`object`	Resumen de ingresos: totalRevenue, indicador isCustomer, timeToFirstConversion (segundos, o null)
`profile`	`object \| null`	Datos del usuario identificado (userId, name, email) si se llamo a identify. Null para visitantes anonimos
`activityTimeline`	`array`	Lista 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/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
      }
    ]
  }
}