Passer au contenu principal
GET
/
api
/
v1
/
radar
/
people
/
details
Détails d'une personne
curl --request GET \
  --url https://taap.it/api/v1/radar/people/details \
  --header 'Authorization: <authorization>'
{
  "error": "Visitor not found"
}
Renvoie une personne (visiteur) avec son profil, la liste de ses sessions sur la plage, et une heatmap d’activité quotidienne. Les réponses sont toujours recalculées (non mises en cache). Requête :
cURL
curl -X GET 'https://taap.it/api/v1/radar/people/details?visitorId=v_8a1c2d&start=2026-01-01T00:00:00Z&end=2026-01-31T23:59:59Z' \
  -H 'Authorization: Bearer taapit_votre_cle_api_ici'
Réponse : 
{
  "data": {
    "visitor": {
      "visitorId": "v_8a1c2d",
      "name": "Quiet Fox",
      "email": "jane@example.com",
      "status": "identified",
      "countryCode": "FR",
      "countryName": "France",
      "source": "google",
      "browser": "Chrome",
      "device": "desktop",
      "revenue": 120.0,
      "sessions": 4,
      "firstSeen": "2026-01-03T09:12:00.000Z",
      "lastSeen": "2026-01-28T17:42:00.000Z"
    },
    "sessions": [
      {
        "sessionId": "s_5f2a",
        "startTime": "2026-01-28T17:10:00.000Z",
        "endTime": "2026-01-28T17:42:00.000Z",
        "durationSeconds": 1920,
        "referrer": "google",
        "device": "desktop",
        "browser": "Chrome",
        "os": "macOS"
      }
    ],
    "heatmap": [
      { "date": "2026-01-28", "events": 12 }
    ]
  }
}

​
Autorisation

​
Authorization
string
requis
Jeton Bearer avec votre clé API Radar. Format : Bearer taapit_...

​
Paramètres de requête

​
visitorId
string
requis
L’identifiant du visiteur renvoyé par l’endpoint Personnes.
​
start
string
requis
Début de la plage, ISO 8601 (UTC).
​
end
string
requis
Fin de la plage, ISO 8601 (UTC).

​
Champs de réponse

​
data.visitor
object
Le profil de la personne (même forme qu’une ligne de l’endpoint Personnes).
​
data.sessions
array
Sessions sur la plage.
​
data.heatmap
array
Activité quotidienne, chaque entrée avec date (YYYY-MM-DD) et le nombre d’events.
{
  "error": "Visitor not found"
}