Passer au contenu principal
GET
/
api
/
v1
/
radar
/
people
Personnes
curl --request GET \
  --url https://taap.it/api/v1/radar/people \
  --header 'Authorization: <authorization>'
{
  "data": [
    {
      "visitorId": "<string>",
      "name": "<string>",
      "email": {},
      "status": "<string>",
      "countryCode": "<string>",
      "countryName": "<string>",
      "source": "<string>",
      "browser": "<string>",
      "device": "<string>",
      "revenue": 123,
      "sessions": 123,
      "events": 123,
      "firstSeen": "<string>",
      "lastSeen": "<string>"
    }
  ],
  "total": 123,
  "limit": 123
}
Renvoie une liste paginée de personnes (visiteurs) sur la plage de dates demandée, avec leurs attributs clés (identité, localisation, source, appareil, revenus, sessions). Filtres optionnels disponibles. Requête :
cURL
curl -X GET 'https://taap.it/api/v1/radar/people?start=2026-01-01T00:00:00Z&end=2026-01-31T23:59:59Z&limit=50&sort=recent' \
  -H 'Authorization: Bearer taapit_votre_cle_api_ici'
Réponse : 
{
  "data": [
    {
      "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,
      "events": 37,
      "firstSeen": "2026-01-03T09:12:00.000Z",
      "lastSeen": "2026-01-28T17:42:00.000Z"
    }
  ],
  "total": 1842,
  "limit": 50
}

​
Autorisation

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

​
Paramètres de requête

​
start
string
requis
Début de la plage, ISO 8601 (UTC). Exemple : 2026-01-01T00:00:00Z.
​
end
string
requis
Fin de la plage, ISO 8601 (UTC). Exemple : 2026-01-31T23:59:59Z.
​
sort
string
défaut:"recent"
Ordre de tri. recent (dernière activité), revenue, sessions ou events.
​
limit
integer
défaut:"200"
Nombre maximal de personnes à renvoyer. Plafonné à 1000.
​
country
string
Filtrer par code pays ISO-2 (ex. FR).
​
browser
string
Filtrer par navigateur (ex. Chrome).
​
device
string
Filtrer par type d’appareil (desktop, mobile, tablet).
​
referrer
string
Filtrer par source de trafic / référent.
​
identity
string
Filtrer par statut d’identité (identified ou anonymous).
​
activity
string
Filtrer par niveau d’activité.

​
Champs de réponse

​
data
array
requis
Tableau de personnes.
​
total
integer
Nombre total de personnes sur la plage (sans filtre). Égal à data.length lorsque des filtres sont appliqués.
​
limit
integer
La limite effective appliquée à cette réponse.