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

# Obtenir l'analyse des performances des Tâches

> **Offre requise :** Offre Standard, Offre Professionnelle ou Offre Entreprise.

Récupérez les indicateurs de collecte et d'exécution des Tâches pour une plage de dates donnée. Utilisez ce point de terminaison pour examiner le volume collecté par chaque Tâche, sa fréquence d'exécution, ses taux de réussite, sa durée d'exécution et les ressources consommées. Les résultats peuvent être regroupés par jour, semaine ou mois.

Les dates utilisent les jours calendaires UTC et la plage doit se situer dans les trois derniers mois. Si `memberNames` est omis ou vide, les résultats sont limités à l'utilisateur actuel ; les membres indiqués doivent appartenir à son équipe.



## OpenAPI

````yaml /fr/api/openapi.json post /taskanalytics/queries
openapi: 3.0.1
info:
  title: API Octoparse
  description: >-
    L'OpenAPI Octoparse permet de gérer les Tâches par programmation, de lancer
    des Extractions dans le cloud et de récupérer les données extraites. URL de
    base : `https://openapi.octoparse.com`
  version: 1.0.0
servers:
  - url: https://openapi.octoparse.com
    description: Serveur API Octoparse
security: []
paths:
  /taskanalytics/queries:
    post:
      tags:
        - Task
      summary: Obtenir l'analyse des performances des Tâches
      description: >-
        **Offre requise :** Offre Standard, Offre Professionnelle ou Offre
        Entreprise.


        Récupérez les indicateurs de collecte et d'exécution des Tâches pour une
        plage de dates donnée. Utilisez ce point de terminaison pour examiner le
        volume collecté par chaque Tâche, sa fréquence d'exécution, ses taux de
        réussite, sa durée d'exécution et les ressources consommées. Les
        résultats peuvent être regroupés par jour, semaine ou mois.


        Les dates utilisent les jours calendaires UTC et la plage doit se situer
        dans les trois derniers mois. Si `memberNames` est omis ou vide, les
        résultats sont limités à l'utilisateur actuel ; les membres indiqués
        doivent appartenir à son équipe.
      operationId: taskAnalyticsQueries
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - start
                - end
              properties:
                start:
                  type: string
                  format: date
                  description: Date de début incluse au format `yyyy-MM-dd`.
                  example: '2026-02-01'
                end:
                  type: string
                  format: date
                  description: >-
                    Date de fin incluse. Elle ne doit être ni postérieure à la
                    date UTC actuelle ni antérieure à `start`.
                  example: '2026-04-01'
                page:
                  type: integer
                  minimum: 1
                  default: 1
                  description: Numéro de page.
                pageSize:
                  type: integer
                  minimum: 1
                  maximum: 100
                  default: 20
                  description: Nombre de résultats par page.
                taskIds:
                  type: array
                  maxItems: 100
                  description: >-
                    Identifiants des Tâches à inclure. Omettez ce champ pour
                    inclure toutes les Tâches.
                  items:
                    type: string
                memberNames:
                  type: array
                  maxItems: 100
                  description: >-
                    Noms des membres de l'équipe à inclure. Omettez ce champ ou
                    laissez-le vide pour interroger uniquement l'utilisateur
                    actuel.
                  items:
                    type: string
                collectionMethod:
                  type: string
                  enum:
                    - Cloud
                    - Local
                    - All
                  default: All
                  description: >-
                    Filtrez selon l'Extraction dans le cloud ou locale. Utilisez
                    `All` ou omettez ce champ pour inclure les deux.
                timeGranularity:
                  type: string
                  enum:
                    - Day
                    - Week
                    - Month
                  default: Day
                  description: Mode de regroupement temporel des résultats.
              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: Analyses de la Tâche renvoyées avec succès.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      total:
                        type: integer
                        description: Nombre total de lignes correspondantes.
                      data:
                        type: array
                        description: Enregistrements d'analyse de la page actuelle.
                        items:
                          type: object
                          properties:
                            taskId:
                              type: string
                              description: Identifiant de la Tâche.
                            userId:
                              type: string
                              description: Identifiant de l'utilisateur.
                            taskName:
                              type: string
                              nullable: true
                              description: Nom de la Tâche.
                            dayKey:
                              type: string
                              description: >-
                                Période calendaire représentée par cet
                                enregistrement.
                            weekStartDate:
                              type: string
                              format: date
                              nullable: true
                              description: >-
                                Début de la semaine lorsque `timeGranularity`
                                vaut `Week`.
                            weekEndDate:
                              type: string
                              format: date
                              nullable: true
                              description: >-
                                Fin de la semaine lorsque `timeGranularity` vaut
                                `Week`.
                            collectionMethod:
                              type: string
                              enum:
                                - Cloud
                                - Local
                              description: Méthode d'extraction.
                            dataVolumeMetrics:
                              type: object
                              description: Volume de données collecté.
                              properties:
                                totalCollected:
                                  type: number
                                  nullable: true
                                  description: Nombre total d'enregistrements collectés.
                                deduplicatedVolume:
                                  type: number
                                  nullable: true
                                  description: >-
                                    Enregistrements restants après
                                    Déduplication.
                            executionMetrics:
                              type: object
                              description: Résultats et durée des exécutions de la Tâche.
                              properties:
                                runCount:
                                  type: number
                                  nullable: true
                                  description: Nombre total d'exécutions.
                                successCount:
                                  type: number
                                  nullable: true
                                  description: Exécutions réussies.
                                failureCount:
                                  type: number
                                  nullable: true
                                  description: Exécutions ayant échoué.
                                durationPerRunSeconds:
                                  type: number
                                  format: double
                                  nullable: true
                                  description: Durée moyenne par exécution, en secondes.
                                totalExecutionSeconds:
                                  type: number
                                  format: double
                                  nullable: true
                                  description: Durée totale d'exécution, en secondes.
                                successRate:
                                  type: number
                                  format: double
                                  minimum: 0
                                  maximum: 1
                                  nullable: true
                                  description: Proportion d'exécutions réussies, de 0 à 1.
                                failureRate:
                                  type: number
                                  format: double
                                  minimum: 0
                                  maximum: 1
                                  nullable: true
                                  description: >-
                                    Proportion d'exécutions ayant échoué, de 0 à
                                    1.
                            resourceUsageMetrics:
                              type: object
                              description: >-
                                Ressources consommées par les exécutions de la
                                Tâche.
                              properties:
                                captchaCount:
                                  type: number
                                  nullable: true
                                  description: CAPTCHA traités.
                                simpleTemplateCount:
                                  type: number
                                  nullable: true
                                  description: Utilisation d'un Modèle simple.
                                proxyIpCount:
                                  type: number
                                  format: double
                                  nullable: true
                                  description: Utilisation des IP de Proxy.
                                balance:
                                  type: number
                                  format: double
                                  nullable: true
                                  description: Coût des ressources.
                  requestId:
                    type: string
                    description: Identifiant de la requête.
              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: Paramètres de requête non valides.
          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

````