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

Procure dados de identidade, atividade, receita e perfil de um visitante específico utilizando o visitId interno devolvido por Flowsery.

Chave API (Bearer token)

Identificacao do visitante

Utilize o visitante interno dos registos Flowsery ou das respostas API. Não passe o cookie _fs_vid do browser diretamente como parâmetro de rota.

Campos de resposta

ParametroTipoDescricao
identityobjectLocalizacao geografica, tipo de dispositivo, navegador, sistema operacional e dimensoes do viewport da ultima visualizacao de pagina
sourcestring | nullFonte de trafego original que trouxe este visitante (dominio de referencia ou fonte UTM)
sourceIconUrlstring | nullURL do favicon da fonte de trafego
activityobjectContagens de visitas e visualizacoes de pagina, informacoes de tempo, ultima URL, objetivos concluidos e lista de paginas visitadas
revenueobjectResumo de receita: totalRevenue, indicador isCustomer, timeToFirstConversion (segundos, ou null)
profileobject | nullDados do usuario identificado (userId, name, email) se identify foi chamado. Null para visitantes anonimos
activityTimelinearrayLista cronologica combinada de todas as visualizacoes de pagina, objetivos concluidos e pagamentos para este visitante
Exemplo de requisicao (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
      }
    ]
  }
}