> ## Documentation Index
> Fetch the complete documentation index at: https://docs.taap.it/llms.txt
> Use this file to discover all available pages before exploring further.

# Personnes

> Lister les personnes (visiteurs) du projet lié à votre clé API

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 :**

```bash cURL theme={null}
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 :**

```json theme={null}
{
  "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

<ParamField header="Authorization" type="string" required>
  Jeton Bearer avec votre clé API Radar. Format : `Bearer taapit_...`
</ParamField>

## Paramètres de requête

<ParamField query="start" type="string" required>
  Début de la plage, ISO 8601 (UTC). Exemple : `2026-01-01T00:00:00Z`.
</ParamField>

<ParamField query="end" type="string" required>
  Fin de la plage, ISO 8601 (UTC). Exemple : `2026-01-31T23:59:59Z`.
</ParamField>

<ParamField query="sort" type="string" default="recent">
  Ordre de tri. `recent` (dernière activité), `revenue`, `sessions` ou `events`.
</ParamField>

<ParamField query="limit" type="integer" default="200">
  Nombre maximal de personnes à renvoyer. Plafonné à `1000`.
</ParamField>

<ParamField query="country" type="string">
  Filtrer par code pays ISO-2 (ex. `FR`).
</ParamField>

<ParamField query="browser" type="string">
  Filtrer par navigateur (ex. `Chrome`).
</ParamField>

<ParamField query="device" type="string">
  Filtrer par type d'appareil (`desktop`, `mobile`, `tablet`).
</ParamField>

<ParamField query="referrer" type="string">
  Filtrer par source de trafic / référent.
</ParamField>

<ParamField query="identity" type="string">
  Filtrer par statut d'identité (`identified` ou `anonymous`).
</ParamField>

<ParamField query="activity" type="string">
  Filtrer par niveau d'activité.
</ParamField>

## Champs de réponse

<ResponseField name="data" type="array" required>
  Tableau de personnes.

  <Expandable title="Personne" defaultOpen>
    <ResponseField name="visitorId" type="string">Identifiant stable du visiteur.</ResponseField>
    <ResponseField name="name" type="string">Nom réel si connu, sinon un alias généré.</ResponseField>
    <ResponseField name="email" type="string | null">E-mail lorsque le visiteur est identifié.</ResponseField>
    <ResponseField name="status" type="string">`identified` ou `anonymous`.</ResponseField>
    <ResponseField name="countryCode" type="string">Code pays ISO-2, ou `XX` si inconnu.</ResponseField>
    <ResponseField name="countryName" type="string">Nom de pays lisible.</ResponseField>
    <ResponseField name="source" type="string">Source de trafic / référent.</ResponseField>
    <ResponseField name="browser" type="string">Navigateur.</ResponseField>
    <ResponseField name="device" type="string">Type d'appareil.</ResponseField>
    <ResponseField name="revenue" type="number">Revenus attribués au total.</ResponseField>
    <ResponseField name="sessions" type="number">Nombre de sessions.</ResponseField>
    <ResponseField name="events" type="number">Nombre d'événements.</ResponseField>
    <ResponseField name="firstSeen" type="string">Première activité, ISO 8601.</ResponseField>
    <ResponseField name="lastSeen" type="string">Dernière activité, ISO 8601.</ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="total" type="integer">
  Nombre total de personnes sur la plage (sans filtre). Égal à `data.length` lorsque des filtres
  sont appliqués.
</ResponseField>

<ResponseField name="limit" type="integer">
  La limite effective appliquée à cette réponse.
</ResponseField>