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

# Ottenere l'analisi delle prestazioni delle attività

> **Piano richiesto:** Standard, Professionale o Enterprise.

Recupera le metriche di raccolta ed esecuzione delle attività per l'intervallo di date selezionato. Usa questo endpoint per verificare quanti dati ha raccolto ogni attività, con quale frequenza è stata eseguita, la percentuale di riuscita, il tempo di esecuzione e le risorse consumate. I risultati possono essere raggruppati per giorno, settimana o mese.

Le date utilizzano giorni di calendario UTC e l'intervallo deve rientrare negli ultimi tre mesi. Se `memberNames` viene omesso o è vuoto, i risultati sono limitati all'utente corrente; i membri specificati devono appartenere al team dell'utente corrente.



## OpenAPI

````yaml /it/api/openapi.json post /taskanalytics/queries
openapi: 3.0.1
info:
  title: API Octoparse
  description: >-
    Octoparse OpenAPI consente di gestire le attività tramite codice, eseguire
    estrazioni cloud e recuperare i dati estratti. URL di base:
    `https://openapi.octoparse.com`
  version: 1.0.0
servers:
  - url: https://openapi.octoparse.com
    description: Server API Octoparse
security: []
paths:
  /taskanalytics/queries:
    post:
      tags:
        - Task
      summary: Ottenere l'analisi delle prestazioni delle attività
      description: >-
        **Piano richiesto:** Standard, Professionale o Enterprise.


        Recupera le metriche di raccolta ed esecuzione delle attività per
        l'intervallo di date selezionato. Usa questo endpoint per verificare
        quanti dati ha raccolto ogni attività, con quale frequenza è stata
        eseguita, la percentuale di riuscita, il tempo di esecuzione e le
        risorse consumate. I risultati possono essere raggruppati per giorno,
        settimana o mese.


        Le date utilizzano giorni di calendario UTC e l'intervallo deve
        rientrare negli ultimi tre mesi. Se `memberNames` viene omesso o è
        vuoto, i risultati sono limitati all'utente corrente; i membri
        specificati devono appartenere al team dell'utente corrente.
      operationId: taskAnalyticsQueries
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - start
                - end
              properties:
                start:
                  type: string
                  format: date
                  description: Data iniziale inclusa nel formato `yyyy-MM-dd`.
                  example: '2026-02-01'
                end:
                  type: string
                  format: date
                  description: >-
                    Data finale inclusa. Non può essere successiva alla data UTC
                    corrente né precedente a `start`.
                  example: '2026-04-01'
                page:
                  type: integer
                  minimum: 1
                  default: 1
                  description: Numero di pagina.
                pageSize:
                  type: integer
                  minimum: 1
                  maximum: 100
                  default: 20
                  description: Numero di risultati per pagina.
                taskIds:
                  type: array
                  maxItems: 100
                  description: >-
                    ID delle attività da includere. Ometti il campo per
                    includere tutte le attività.
                  items:
                    type: string
                memberNames:
                  type: array
                  maxItems: 100
                  description: >-
                    Nomi dei membri del team da includere. Ometti il campo o
                    lascialo vuoto per interrogare solo l'utente corrente.
                  items:
                    type: string
                collectionMethod:
                  type: string
                  enum:
                    - Cloud
                    - Local
                    - All
                  default: All
                  description: >-
                    Filtra per estrazione cloud o locale. Usa `All` oppure
                    ometti il campo per includerle entrambe.
                timeGranularity:
                  type: string
                  enum:
                    - Day
                    - Week
                    - Month
                  default: Day
                  description: Modalità di raggruppamento temporale dei risultati.
              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: Analisi delle attività restituita correttamente.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      total:
                        type: integer
                        description: Numero totale di righe corrispondenti.
                      data:
                        type: array
                        description: Record di analisi per la pagina corrente.
                        items:
                          type: object
                          properties:
                            taskId:
                              type: string
                              description: ID dell'attività.
                            userId:
                              type: string
                              description: ID utente.
                            taskName:
                              type: string
                              nullable: true
                              description: Nome dell'attività.
                            dayKey:
                              type: string
                              description: >-
                                Intervallo di date rappresentato da questo
                                record.
                            weekStartDate:
                              type: string
                              format: date
                              nullable: true
                              description: >-
                                Inizio della settimana quando `timeGranularity`
                                è `Week`.
                            weekEndDate:
                              type: string
                              format: date
                              nullable: true
                              description: >-
                                Fine della settimana quando `timeGranularity` è
                                `Week`.
                            collectionMethod:
                              type: string
                              enum:
                                - Cloud
                                - Local
                              description: Metodo di estrazione.
                            dataVolumeMetrics:
                              type: object
                              description: Volume dei dati raccolti.
                              properties:
                                totalCollected:
                                  type: number
                                  nullable: true
                                  description: Totale dei record raccolti.
                                deduplicatedVolume:
                                  type: number
                                  nullable: true
                                  description: Record rimasti dopo la deduplicazione.
                            executionMetrics:
                              type: object
                              description: >-
                                Risultati e durata delle esecuzioni
                                dell'attività.
                              properties:
                                runCount:
                                  type: number
                                  nullable: true
                                  description: Esecuzioni totali.
                                successCount:
                                  type: number
                                  nullable: true
                                  description: Esecuzioni riuscite.
                                failureCount:
                                  type: number
                                  nullable: true
                                  description: Esecuzioni non riuscite.
                                durationPerRunSeconds:
                                  type: number
                                  format: double
                                  nullable: true
                                  description: Durata media per esecuzione, in secondi.
                                totalExecutionSeconds:
                                  type: number
                                  format: double
                                  nullable: true
                                  description: Tempo totale di esecuzione, in secondi.
                                successRate:
                                  type: number
                                  format: double
                                  minimum: 0
                                  maximum: 1
                                  nullable: true
                                  description: >-
                                    Percentuale di esecuzioni riuscite come
                                    valore da 0 a 1.
                                failureRate:
                                  type: number
                                  format: double
                                  minimum: 0
                                  maximum: 1
                                  nullable: true
                                  description: >-
                                    Percentuale di esecuzioni non riuscite come
                                    valore da 0 a 1.
                            resourceUsageMetrics:
                              type: object
                              description: >-
                                Risorse consumate dalle esecuzioni
                                dell'attività.
                              properties:
                                captchaCount:
                                  type: number
                                  nullable: true
                                  description: CAPTCHA elaborati.
                                simpleTemplateCount:
                                  type: number
                                  nullable: true
                                  description: Utilizzo dei modelli semplici.
                                proxyIpCount:
                                  type: number
                                  format: double
                                  nullable: true
                                  description: Utilizzo degli IP Proxy.
                                balance:
                                  type: number
                                  format: double
                                  nullable: true
                                  description: Costo delle risorse.
                  requestId:
                    type: string
                    description: ID della richiesta.
              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: Parametri della richiesta non validi.
          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

````