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

# Leistungsanalyse der Aufgaben abrufen

> **Erforderlicher Plan:** Standard, Professional oder Enterprise.

Rufen Sie Erfassungs- und Ausführungskennzahlen von Aufgaben für einen ausgewählten Zeitraum ab. Mit diesem Endpunkt können Sie prüfen, wie viele Daten jede Aufgabe erfasst hat, wie oft sie ausgeführt wurde, wie hoch Erfolgsrate und Ausführungsdauer waren und welche Ressourcen sie verbraucht hat. Ergebnisse lassen sich nach Tag, Woche oder Monat gruppieren.

Datumswerte verwenden UTC-Kalendertage; der Zeitraum muss innerhalb der letzten drei Monate liegen. Wenn `memberNames` ausgelassen oder leer ist, werden die Ergebnisse auf den aktuellen Benutzer beschränkt; angegebene Mitglieder müssen zum Team des aktuellen Benutzers gehören.



## OpenAPI

````yaml /de/api/openapi.json post /taskanalytics/queries
openapi: 3.0.1
info:
  title: Octoparse API
  description: >-
    Mit der Octoparse OpenAPI können Sie Aufgaben programmgesteuert verwalten,
    Cloud-Extraktionen ausführen und gescrapte Daten abrufen. Basis-URL:
    `https://openapi.octoparse.com`
  version: 1.0.0
servers:
  - url: https://openapi.octoparse.com
    description: Octoparse API-Server
security: []
paths:
  /taskanalytics/queries:
    post:
      tags:
        - Task
      summary: Leistungsanalyse der Aufgaben abrufen
      description: >-
        **Erforderlicher Plan:** Standard, Professional oder Enterprise.


        Rufen Sie Erfassungs- und Ausführungskennzahlen von Aufgaben für einen
        ausgewählten Zeitraum ab. Mit diesem Endpunkt können Sie prüfen, wie
        viele Daten jede Aufgabe erfasst hat, wie oft sie ausgeführt wurde, wie
        hoch Erfolgsrate und Ausführungsdauer waren und welche Ressourcen sie
        verbraucht hat. Ergebnisse lassen sich nach Tag, Woche oder Monat
        gruppieren.


        Datumswerte verwenden UTC-Kalendertage; der Zeitraum muss innerhalb der
        letzten drei Monate liegen. Wenn `memberNames` ausgelassen oder leer
        ist, werden die Ergebnisse auf den aktuellen Benutzer beschränkt;
        angegebene Mitglieder müssen zum Team des aktuellen Benutzers gehören.
      operationId: taskAnalyticsQueries
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - start
                - end
              properties:
                start:
                  type: string
                  format: date
                  description: Startdatum (einschließlich) im Format `yyyy-MM-dd`.
                  example: '2026-02-01'
                end:
                  type: string
                  format: date
                  description: >-
                    Enddatum (einschließlich). Darf weder nach dem aktuellen
                    UTC-Datum noch vor `start` liegen.
                  example: '2026-04-01'
                page:
                  type: integer
                  minimum: 1
                  default: 1
                  description: Seitennummer.
                pageSize:
                  type: integer
                  minimum: 1
                  maximum: 100
                  default: 20
                  description: Anzahl der Ergebnisse pro Seite.
                taskIds:
                  type: array
                  maxItems: 100
                  description: >-
                    Einzubeziehende Aufgaben-IDs. Lassen Sie das Feld aus, um
                    alle Aufgaben einzubeziehen.
                  items:
                    type: string
                memberNames:
                  type: array
                  maxItems: 100
                  description: >-
                    Einzubeziehende Namen von Teammitgliedern. Lassen Sie das
                    Feld aus oder leer, um nur den aktuellen Benutzer
                    abzufragen.
                  items:
                    type: string
                collectionMethod:
                  type: string
                  enum:
                    - Cloud
                    - Local
                    - All
                  default: All
                  description: >-
                    Nach Cloud- oder lokaler Extraktion filtern. Verwenden Sie
                    für beide `All` oder lassen Sie das Feld aus.
                timeGranularity:
                  type: string
                  enum:
                    - Day
                    - Week
                    - Month
                  default: Day
                  description: Zeitliche Gruppierung der Ergebnisse.
              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: Aufgabenanalysen erfolgreich zurückgegeben.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      total:
                        type: integer
                        description: Gesamtzahl der übereinstimmenden Zeilen.
                      data:
                        type: array
                        description: Analysedatensätze der aktuellen Seite.
                        items:
                          type: object
                          properties:
                            taskId:
                              type: string
                              description: Aufgaben-ID.
                            userId:
                              type: string
                              description: Benutzer-ID.
                            taskName:
                              type: string
                              nullable: true
                              description: Aufgabenname.
                            dayKey:
                              type: string
                              description: >-
                                Von diesem Datensatz dargestellter
                                Datumszeitraum.
                            weekStartDate:
                              type: string
                              format: date
                              nullable: true
                              description: >-
                                Wochenbeginn, wenn `timeGranularity` den Wert
                                `Week` hat.
                            weekEndDate:
                              type: string
                              format: date
                              nullable: true
                              description: >-
                                Wochenende, wenn `timeGranularity` den Wert
                                `Week` hat.
                            collectionMethod:
                              type: string
                              enum:
                                - Cloud
                                - Local
                              description: Extraktionsmethode.
                            dataVolumeMetrics:
                              type: object
                              description: Umfang der erfassten Daten.
                              properties:
                                totalCollected:
                                  type: number
                                  nullable: true
                                  description: Gesamtzahl erfasster Datensätze.
                                deduplicatedVolume:
                                  type: number
                                  nullable: true
                                  description: >-
                                    Nach der Deduplizierung verbleibende
                                    Datensätze.
                            executionMetrics:
                              type: object
                              description: Ergebnisse und Dauer der Aufgabenläufe.
                              properties:
                                runCount:
                                  type: number
                                  nullable: true
                                  description: Gesamtzahl der Läufe.
                                successCount:
                                  type: number
                                  nullable: true
                                  description: Erfolgreiche Läufe.
                                failureCount:
                                  type: number
                                  nullable: true
                                  description: Fehlgeschlagene Läufe.
                                durationPerRunSeconds:
                                  type: number
                                  format: double
                                  nullable: true
                                  description: >-
                                    Durchschnittliche Dauer pro Lauf in
                                    Sekunden.
                                totalExecutionSeconds:
                                  type: number
                                  format: double
                                  nullable: true
                                  description: Gesamtausführungszeit in Sekunden.
                                successRate:
                                  type: number
                                  format: double
                                  minimum: 0
                                  maximum: 1
                                  nullable: true
                                  description: >-
                                    Anteil erfolgreicher Läufe als Wert zwischen
                                    0 und 1.
                                failureRate:
                                  type: number
                                  format: double
                                  minimum: 0
                                  maximum: 1
                                  nullable: true
                                  description: >-
                                    Anteil fehlgeschlagener Läufe als Wert
                                    zwischen 0 und 1.
                            resourceUsageMetrics:
                              type: object
                              description: Von Aufgabenläufen verbrauchte Ressourcen.
                              properties:
                                captchaCount:
                                  type: number
                                  nullable: true
                                  description: Verarbeitete CAPTCHAs.
                                simpleTemplateCount:
                                  type: number
                                  nullable: true
                                  description: Nutzung einfacher Vorlagen.
                                proxyIpCount:
                                  type: number
                                  format: double
                                  nullable: true
                                  description: Nutzung von Proxy-IPs.
                                balance:
                                  type: number
                                  format: double
                                  nullable: true
                                  description: Ressourcenkosten.
                  requestId:
                    type: string
                    description: Anfrage-ID.
              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: Ungültige Anfrageparameter.
          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

````