# Obtener estadísticas de llamadas del assistant (/es/api/analytics/assistant-caller-stats)

<!-- agent-signals: reading_time_min: 3 · est_tokens: 1294 · updated: 2026-07-30 -->
Related: [Obtener comentarios](/es/api/analytics/feedback.md), [Obtener conversaciones del assistant](/es/api/analytics/assistant-conversations.md), [Iniciar job de exportación estática](/es/api/static-export/start-job.md)

<div id="usage">
  ## Uso [#uso]
</div>

Utiliza este endpoint para ver cómo se distribuyen las consultas del assistant entre los diferentes tipos de origen. La respuesta desglosa el total de consultas en:

* `web`: Consultas desde el sitio de documentación
* `api`: Consultas desde llamadas directas a la API
* `other`: Consultas desde otras fuentes (por ejemplo, integraciones, SDKs)
* **total**: Suma de todos los tipos de consulta

<div id="filtering">
  ## Filtrado [#filtrado]
</div>

Filtra por rango de fechas usando los parámetros `dateFrom` y `dateTo`.

## Límites de uso [#límites-de-uso]

Este endpoint permite 100 solicitudes por organización por hora. Todos los endpoints de analytics comparten este límite.

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

Devuelve un desglose del número de consultas del assistant por tipo de origen (web, API y otros) para el rango de fechas especificado.

Autentícate con una clave de API de administrador.

## OpenAPI

```json
{
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "parameters": [
    {
      "schema": {
        "type": "string",
        "description": "Tu ID de proyecto. Puedes copiarlo desde la página [API keys](https://dashboard.mintlify.com/settings/organization/api-keys) en tu dashboard."
      },
      "required": true,
      "name": "projectId",
      "in": "path"
    },
    {
      "schema": {
        "type": "string",
        "description": "Fecha en formato ISO 8601 o AAAA-MM-DD",
        "example": "2024-01-01"
      },
      "required": false,
      "name": "dateFrom",
      "in": "query"
    },
    {
      "schema": {
        "type": "string",
        "description": "Fecha en formato ISO 8601 o AAAA-MM-DD. `dateTo` es un límite superior exclusivo. Los resultados incluyen fechas anteriores, pero no la fecha especificada.",
        "example": "2024-01-01"
      },
      "required": false,
      "name": "dateTo",
      "in": "query"
    }
  ],
  "responses": {
    "200": {
      "description": "Número de consultas del assistant desglosado por tipo de origen",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "web": {
                "type": "number",
                "description": "Número de consultas del assistant originadas desde la web (sitio de documentación)."
              },
              "api": {
                "type": "number",
                "description": "Número de consultas del assistant originadas desde llamadas a la API."
              },
              "other": {
                "type": "number",
                "description": "Número de consultas del assistant desde otras fuentes (por ejemplo, integraciones, SDKs)."
              },
              "total": {
                "type": "number",
                "description": "Total de consultas del assistant en todos los tipos de origen."
              }
            },
            "required": [
              "web",
              "api",
              "other",
              "total"
            ]
          }
        }
      }
    },
    "400": {
      "description": "Parámetros de búsqueda no válidos",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "error": {
                "type": "string",
                "description": "Mensaje de error que describe lo que salió mal."
              },
              "details": {
                "type": "array",
                "description": "Detalles adicionales del error.",
                "items": {
                  "type": "object",
                  "properties": {
                    "message": {
                      "type": "string",
                      "description": "Descripción de un error específico de validación o procesamiento."
                    }
                  },
                  "required": [
                    "message"
                  ]
                }
              }
            },
            "required": [
              "error"
            ]
          }
        }
      }
    },
    "500": {
      "description": "Error del servidor",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "error": {
                "type": "string",
                "description": "Mensaje de error que describe lo que salió mal."
              },
              "details": {
                "type": "array",
                "description": "Detalles adicionales del error.",
                "items": {
                  "type": "object",
                  "properties": {
                    "message": {
                      "type": "string",
                      "description": "Descripción de un error específico de validación o procesamiento."
                    }
                  },
                  "required": [
                    "message"
                  ]
                }
              }
            },
            "required": [
              "error"
            ]
          }
        }
      }
    }
  }
}
```
