> ## Documentation Index > Fetch the complete documentation index at: https://www.octoparse.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Obtener analíticas de rendimiento de las tareas > **Plan requerido:** Plan Estándar, Plan Profesional o Plan Empresarial. Recupera las métricas de recopilación y ejecución de tareas para un intervalo de fechas seleccionado. Usa este endpoint para revisar cuántos datos recopiló cada tarea, con qué frecuencia se ejecutó, su tasa de éxito y tiempo de ejecución, y los recursos que consumió. Los resultados pueden agruparse por día, semana o mes. Las fechas usan días naturales en UTC y el intervalo debe estar comprendido dentro de los últimos tres meses. Si `memberNames` se omite o está vacío, los resultados se limitan al usuario actual; los miembros especificados deben pertenecer al equipo del usuario actual. ## OpenAPI ````yaml /es/api/openapi.json post /taskanalytics/queries openapi: 3.0.1 info: title: API de Octoparse description: >- La OpenAPI de Octoparse permite gestionar tareas mediante programación, ejecutar extracciones en la nube y recuperar los datos extraídos. URL base: `https://openapi.octoparse.com` version: 1.0.0 servers: - url: https://openapi.octoparse.com description: Servidor de la API de Octoparse security: [] paths: /taskanalytics/queries: post: tags: - Task summary: Obtener analíticas de rendimiento de las tareas description: >- **Plan requerido:** Plan Estándar, Plan Profesional o Plan Empresarial. Recupera las métricas de recopilación y ejecución de tareas para un intervalo de fechas seleccionado. Usa este endpoint para revisar cuántos datos recopiló cada tarea, con qué frecuencia se ejecutó, su tasa de éxito y tiempo de ejecución, y los recursos que consumió. Los resultados pueden agruparse por día, semana o mes. Las fechas usan días naturales en UTC y el intervalo debe estar comprendido dentro de los últimos tres meses. Si `memberNames` se omite o está vacío, los resultados se limitan al usuario actual; los miembros especificados deben pertenecer al equipo del usuario actual. operationId: taskAnalyticsQueries requestBody: required: true content: application/json: schema: type: object required: - start - end properties: start: type: string format: date description: Fecha de inicio (incluida) con el formato `yyyy-MM-dd`. example: '2026-02-01' end: type: string format: date description: >- Fecha de finalización (incluida). No puede ser posterior a la fecha UTC actual ni anterior a `start`. example: '2026-04-01' page: type: integer minimum: 1 default: 1 description: Número de página. pageSize: type: integer minimum: 1 maximum: 100 default: 20 description: Número de resultados por página. taskIds: type: array maxItems: 100 description: >- ID de las tareas que se incluirán. Omite este campo para incluir todas las tareas. items: type: string memberNames: type: array maxItems: 100 description: >- Nombres de los miembros del equipo que se incluirán. Omite el campo o déjalo vacío para consultar solo al usuario actual. items: type: string collectionMethod: type: string enum: - Cloud - Local - All default: All description: >- Filtra por extracción local o en la nube. Usa `All` u omite este campo para incluir ambas. timeGranularity: type: string enum: - Day - Week - Month default: Day description: Cómo se agrupan los resultados a lo largo del tiempo. example: start: '2026-02-01' end: '2026-04-01' page: 1 pageSize: 20 timeGranularity: Week collectionMethod: All taskIds: - task-id-1 memberNames: [] responses: '200': description: Las analíticas de las tareas se devolvieron correctamente. content: application/json: schema: type: object properties: data: type: object properties: total: type: integer description: Número total de filas coincidentes. data: type: array description: Registros de analíticas de la página actual. items: type: object properties: taskId: type: string description: ID de la tarea. userId: type: string description: ID del usuario. taskName: type: string nullable: true description: Nombre de la tarea. dayKey: type: string description: >- Intervalo de fechas representado por este registro. weekStartDate: type: string format: date nullable: true description: >- Inicio de la semana cuando `timeGranularity` es `Week`. weekEndDate: type: string format: date nullable: true description: >- Fin de la semana cuando `timeGranularity` es `Week`. collectionMethod: type: string enum: - Cloud - Local description: Método de extracción. dataVolumeMetrics: type: object description: Volumen de datos recopilados. properties: totalCollected: type: number nullable: true description: Total de registros recopilados. deduplicatedVolume: type: number nullable: true description: >- Registros restantes después de la deduplicación. executionMetrics: type: object description: >- Resultados y duración de las ejecuciones de la tarea. properties: runCount: type: number nullable: true description: Total de ejecuciones. successCount: type: number nullable: true description: Ejecuciones correctas. failureCount: type: number nullable: true description: Ejecuciones fallidas. durationPerRunSeconds: type: number format: double nullable: true description: >- Duración media de cada ejecución, en segundos. totalExecutionSeconds: type: number format: double nullable: true description: Tiempo total de ejecución, en segundos. successRate: type: number format: double minimum: 0 maximum: 1 nullable: true description: >- Ejecuciones correctas como valor entre 0 y 1. failureRate: type: number format: double minimum: 0 maximum: 1 nullable: true description: Ejecuciones fallidas como valor entre 0 y 1. resourceUsageMetrics: type: object description: >- Recursos consumidos por las ejecuciones de la tarea. properties: captchaCount: type: number nullable: true description: CAPTCHA procesados. simpleTemplateCount: type: number nullable: true description: Uso de plantillas sencillas. proxyIpCount: type: number format: double nullable: true description: Uso de direcciones IP de Proxy. balance: type: number format: double nullable: true description: Coste de los recursos. requestId: type: string description: ID de la solicitud. example: data: total: 42 data: - taskId: abc123 userId: user001 taskName: Product scraper dayKey: 2026-W11 weekStartDate: '2026-03-10' weekEndDate: '2026-03-16' collectionMethod: Cloud dataVolumeMetrics: totalCollected: 10000 deduplicatedVolume: 8000 executionMetrics: runCount: 50 successCount: 48 failureCount: 2 durationPerRunSeconds: 12.5 totalExecutionSeconds: 625 successRate: 0.96 failureRate: 0.04 resourceUsageMetrics: captchaCount: 10 simpleTemplateCount: null proxyIpCount: 1.5 balance: 3.2 requestId: 0HMD469L0I8Q1:00000001 '400': description: Parámetros de solicitud no válidos. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' components: schemas: ErrorResponse: type: object properties: error: type: object properties: code: type: integer message: type: string requestId: type: string ````