> ## 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.

# Regroupements

> Récupérer les principales pages, sources, localisations et appareils

Renvoie les principaux regroupements (pages, sources, localisations et appareils) pour le projet
lié à votre clé API sur la plage de dates demandée.

**Requête :**

```bash cURL theme={null}
curl -X GET 'https://taap.it/api/v1/radar/breakdowns?start=2026-01-01T00:00:00Z&end=2026-01-31T23:59:59Z&limit=20' \
  -H 'Authorization: Bearer taapit_votre_cle_api_ici'
```

**Réponse :**

```json theme={null}
{
  "data": {
    "pages": {
      "top": [
        { "pathname": "/", "people": 320 },
        { "pathname": "/pricing", "people": 110 }
      ]
    },
    "sources": {
      "referrer": [
        { "name": "Direct", "people": 210 },
        { "name": "Google", "people": 180 }
      ]
    },
    "locations": {
      "countries": [
        { "name": "France", "people": 240, "countryCode": "FR", "revenue": 980.0 },
        { "name": "Belgium", "people": 90, "countryCode": "BE", "revenue": 120.0 }
      ]
    },
    "devices": {
      "browsers": [
        { "name": "Chrome", "people": 410 },
        { "name": "Safari", "people": 220 }
      ],
      "os": [
        { "name": "Windows", "people": 300 },
        { "name": "iOS", "people": 180 }
      ]
    },
    "events": [
      { "event_name": "signup_click", "people": 40, "events": 52, "completion_rate": 0 }
    ],
    "hostnames": ["www.example.com"]
  }
}
```

## 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="limit" type="integer" default="50">
  Nombre maximal de lignes par regroupement. Doit être un nombre positif. Vaut `50` par défaut.
</ParamField>

## Champs de réponse

<ResponseField name="data" type="object" required>
  Chaque section est optionnelle et omise lorsqu'il n'y a aucune donnée.

  <Expandable title="Regroupements" defaultOpen>
    <ResponseField name="pages.top" type="array">
      Principales pages, chacune avec `pathname` et `people`.
    </ResponseField>

    <ResponseField name="sources.referrer" type="array">
      Principaux référents, chacun avec `name` et `people`.
    </ResponseField>

    <ResponseField name="locations.countries" type="array">
      Principaux pays, chacun avec `name`, `people`, `countryCode` et `revenue`.
    </ResponseField>

    <ResponseField name="devices.browsers" type="array">
      Principaux navigateurs, chacun avec `name` et `people`.
    </ResponseField>

    <ResponseField name="devices.os" type="array">
      Principaux systèmes d'exploitation, chacun avec `name` et `people`.
    </ResponseField>

    <ResponseField name="events" type="array">
      Principaux événements personnalisés, chacun avec `event_name`, `people` et `events`.
    </ResponseField>

    <ResponseField name="hostnames" type="array">
      Noms d'hôtes observés pour le projet sur la plage.
    </ResponseField>
  </Expandable>
</ResponseField>