# Récupérer les statistiques d'appels de l'Assistant (/fr/api/analytics/assistant-caller-stats)

<!-- agent-signals: reading_time_min: 3 · est_tokens: 1315 · updated: 2026-07-30 -->
Related: [Obtenir des retours](/fr/api/analytics/feedback.md), [Récupérer les conversations de l'Assistant](/fr/api/analytics/assistant-conversations.md), [Démarrer une tâche d'exportation statique](/fr/api/static-export/start-job.md)

<div id="usage">
  ## Utilisation [#utilisation]
</div>

Utilisez cet endpoint pour voir comment les requêtes de l'Assistant sont réparties entre les différents types d'appelants. La réponse décompose le total des requêtes en :

* `web` : Requêtes provenant du site de documentation
* `api` : Requêtes provenant d'appels API directs
* `other` : Requêtes provenant d'autres sources (par exemple, intégrations, SDKs)
* **total** : Somme de tous les types de requêtes

<div id="filtering">
  ## Filtrage [#filtrage]
</div>

Filtrez par plage de dates à l'aide des paramètres `dateFrom` et `dateTo`.

<div id="rate-limits">
  ## Limites de débit [#limites-de-débit]
</div>

Cet endpoint autorise 100 requêtes par organisation et par heure. Tous les endpoints d'analytics partagent cette limite.

`GET /v1/analytics/{projectId}/assistant/caller-stats`

Renvoie une répartition du nombre de requêtes de l'Assistant par type d'appelant (web, API et autres) pour la plage de dates spécifiée.

Authentifiez-vous avec une clé d'API administrateur.

## OpenAPI

```json
{
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "parameters": [
    {
      "schema": {
        "type": "string",
        "description": "ID de votre projet. Vous pouvez le copier depuis la page [API keys](https://dashboard.mintlify.com/settings/organization/api-keys) de votre Dashboard."
      },
      "required": true,
      "name": "projectId",
      "in": "path"
    },
    {
      "schema": {
        "type": "string",
        "description": "Date au format ISO 8601 ou AAAA-MM-JJ",
        "example": "2024-01-01"
      },
      "required": false,
      "name": "dateFrom",
      "in": "query"
    },
    {
      "schema": {
        "type": "string",
        "description": "Date au format ISO 8601 ou AAAA-MM-JJ. `dateTo` est une borne supérieure exclusive. Les résultats incluent les dates antérieures, mais pas la date spécifiée.",
        "example": "2024-01-01"
      },
      "required": false,
      "name": "dateTo",
      "in": "query"
    }
  ],
  "responses": {
    "200": {
      "description": "Nombre de requêtes de l'Assistant ventilé par type d'appelant",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "web": {
                "type": "number",
                "description": "Nombre de requêtes de l'Assistant provenant du web (site de documentation)."
              },
              "api": {
                "type": "number",
                "description": "Nombre de requêtes de l'Assistant provenant d'appels API."
              },
              "other": {
                "type": "number",
                "description": "Nombre de requêtes de l'Assistant provenant d'autres sources (par exemple, intégrations, SDKs)."
              },
              "total": {
                "type": "number",
                "description": "Total des requêtes de l'Assistant tous types d'appelants confondus."
              }
            },
            "required": [
              "web",
              "api",
              "other",
              "total"
            ]
          }
        }
      }
    },
    "400": {
      "description": "Paramètres de requête invalides",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "error": {
                "type": "string",
                "description": "Message d’erreur décrivant ce qui s’est mal passé."
              },
              "details": {
                "type": "array",
                "description": "Détails supplémentaires sur l’erreur.",
                "items": {
                  "type": "object",
                  "properties": {
                    "message": {
                      "type": "string",
                      "description": "Description d’une erreur spécifique de validation ou de traitement."
                    }
                  },
                  "required": [
                    "message"
                  ]
                }
              }
            },
            "required": [
              "error"
            ]
          }
        }
      }
    },
    "500": {
      "description": "Erreur serveur",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "error": {
                "type": "string",
                "description": "Message d’erreur décrivant ce qui s’est mal passé."
              },
              "details": {
                "type": "array",
                "description": "Détails supplémentaires sur l’erreur.",
                "items": {
                  "type": "object",
                  "properties": {
                    "message": {
                      "type": "string",
                      "description": "Description d’une erreur spécifique de validation ou de traitement."
                    }
                  },
                  "required": [
                    "message"
                  ]
                }
              }
            },
            "required": [
              "error"
            ]
          }
        }
      }
    }
  }
}
```