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

# Get Task Performance Analytics

> **Required plan:** Standard, Professional, or Enterprise.

Retrieve task collection and execution metrics for a selected date range. Use this endpoint to review how much data each task collected, how often it ran, its success rate and execution time, and the resources it consumed. Results can be grouped by day, week, or month.

Dates use UTC calendar days and the date range must fall within the last three months. If `memberNames` is omitted or empty, results are limited to the current user; specified members must belong to the current user's team.



## OpenAPI

````yaml /en/api/openapi.json post /taskanalytics/queries
openapi: 3.0.1
info:
  title: Octoparse API
  description: >-
    Octoparse OpenAPI allows you to programmatically manage tasks, run cloud
    extractions, and retrieve scraped data. Base 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: Get Task Performance Analytics
      description: >-
        **Required plan:** Standard, Professional, or Enterprise.


        Retrieve task collection and execution metrics for a selected date
        range. Use this endpoint to review how much data each task collected,
        how often it ran, its success rate and execution time, and the resources
        it consumed. Results can be grouped by day, week, or month.


        Dates use UTC calendar days and the date range must fall within the last
        three months. If `memberNames` is omitted or empty, results are limited
        to the current user; specified members must belong to the current user's
        team.
      operationId: taskAnalyticsQueries
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - start
                - end
              properties:
                start:
                  type: string
                  format: date
                  description: Start date (inclusive) in `yyyy-MM-dd` format.
                  example: '2026-02-01'
                end:
                  type: string
                  format: date
                  description: >-
                    End date (inclusive). Must not be after the current UTC date
                    or before `start`.
                  example: '2026-04-01'
                page:
                  type: integer
                  minimum: 1
                  default: 1
                  description: Page number.
                pageSize:
                  type: integer
                  minimum: 1
                  maximum: 100
                  default: 20
                  description: Number of results per page.
                taskIds:
                  type: array
                  maxItems: 100
                  description: Task IDs to include. Omit this field to include all tasks.
                  items:
                    type: string
                memberNames:
                  type: array
                  maxItems: 100
                  description: >-
                    Team member names to include. Omit or leave empty to query
                    only the current user.
                  items:
                    type: string
                collectionMethod:
                  type: string
                  enum:
                    - Cloud
                    - Local
                    - All
                  default: All
                  description: >-
                    Filter by cloud or local extraction. Use `All` or omit this
                    field for both.
                timeGranularity:
                  type: string
                  enum:
                    - Day
                    - Week
                    - Month
                  default: Day
                  description: How results are grouped over time.
              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: Task analytics returned successfully.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      total:
                        type: integer
                        description: Total number of matching rows.
                      data:
                        type: array
                        description: Analytics records for the current page.
                        items:
                          type: object
                          properties:
                            taskId:
                              type: string
                              description: Task ID.
                            userId:
                              type: string
                              description: User ID.
                            taskName:
                              type: string
                              nullable: true
                              description: Task name.
                            dayKey:
                              type: string
                              description: Date bucket represented by this record.
                            weekStartDate:
                              type: string
                              format: date
                              nullable: true
                              description: >-
                                Start of the week when `timeGranularity` is
                                `Week`.
                            weekEndDate:
                              type: string
                              format: date
                              nullable: true
                              description: >-
                                End of the week when `timeGranularity` is
                                `Week`.
                            collectionMethod:
                              type: string
                              enum:
                                - Cloud
                                - Local
                              description: Extraction method.
                            dataVolumeMetrics:
                              type: object
                              description: Collected data volume.
                              properties:
                                totalCollected:
                                  type: number
                                  nullable: true
                                  description: Total records collected.
                                deduplicatedVolume:
                                  type: number
                                  nullable: true
                                  description: Records remaining after deduplication.
                            executionMetrics:
                              type: object
                              description: Task run results and duration.
                              properties:
                                runCount:
                                  type: number
                                  nullable: true
                                  description: Total runs.
                                successCount:
                                  type: number
                                  nullable: true
                                  description: Successful runs.
                                failureCount:
                                  type: number
                                  nullable: true
                                  description: Failed runs.
                                durationPerRunSeconds:
                                  type: number
                                  format: double
                                  nullable: true
                                  description: Average duration per run, in seconds.
                                totalExecutionSeconds:
                                  type: number
                                  format: double
                                  nullable: true
                                  description: Total execution time, in seconds.
                                successRate:
                                  type: number
                                  format: double
                                  minimum: 0
                                  maximum: 1
                                  nullable: true
                                  description: Successful runs as a value from 0 to 1.
                                failureRate:
                                  type: number
                                  format: double
                                  minimum: 0
                                  maximum: 1
                                  nullable: true
                                  description: Failed runs as a value from 0 to 1.
                            resourceUsageMetrics:
                              type: object
                              description: Resources consumed by task runs.
                              properties:
                                captchaCount:
                                  type: number
                                  nullable: true
                                  description: CAPTCHAs processed.
                                simpleTemplateCount:
                                  type: number
                                  nullable: true
                                  description: Simple template usage.
                                proxyIpCount:
                                  type: number
                                  format: double
                                  nullable: true
                                  description: Proxy IP usage.
                                balance:
                                  type: number
                                  format: double
                                  nullable: true
                                  description: Resource cost.
                  requestId:
                    type: string
                    description: Request 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: Invalid request parameters.
          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

````