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

# Métriques

> Récupérer les métriques Radar agrégées sur une plage de dates

Renvoie les métriques agrégées du 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/overview?start=2026-01-01T00:00:00Z&end=2026-01-31T23:59:59Z' \
  -H 'Authorization: Bearer taapit_votre_cle_api_ici'
```

**Réponse :**

```json theme={null}
{
  "data": {
    "people": 1280,
    "visits": 1890,
    "pageviews": 5230,
    "events": 412,
    "revenue": 1990.5,
    "revenue_currency": "EUR",
    "sales": 23,
    "conversion_rate": 1.79,
    "revenue_per_visitor": 1.05,
    "bounce_rate": 38.2,
    "avg_duration_s": 142,
    "avg_duration_mmss": "02:22"
  }
}
```

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

## Champs de réponse

<ResponseField name="data" type="object" required>
  <Expandable title="Métriques" defaultOpen>
    <ResponseField name="people" type="integer">Visiteurs uniques.</ResponseField>
    <ResponseField name="visits" type="integer">Nombre de sessions.</ResponseField>
    <ResponseField name="pageviews" type="integer">Pages vues au total.</ResponseField>
    <ResponseField name="events" type="integer">Événements personnalisés suivis.</ResponseField>
    <ResponseField name="revenue" type="number">Revenus attribués.</ResponseField>
    <ResponseField name="revenue_currency" type="string">Devise ISO 4217 de `revenue`.</ResponseField>
    <ResponseField name="sales" type="integer">Nombre de ventes / conversions.</ResponseField>
    <ResponseField name="conversion_rate" type="number">Taux de conversion (pourcentage).</ResponseField>
    <ResponseField name="revenue_per_visitor" type="number">Revenus divisés par visiteurs uniques.</ResponseField>
    <ResponseField name="bounce_rate" type="number">Taux de rebond (pourcentage).</ResponseField>
    <ResponseField name="avg_duration_s" type="integer">Durée moyenne de session en secondes.</ResponseField>
    <ResponseField name="avg_duration_mmss" type="string">Durée moyenne de session au format `mm:ss`.</ResponseField>
  </Expandable>
</ResponseField>