> ## 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. # 작업 성능 분석 가져오기 > **필수 플랜:** 스탠다드, 프로페셔널 또는 엔터프라이즈. 선택한 날짜 범위의 작업 수집 및 실행 지표를 가져옵니다. 이 엔드포인트를 사용하여 각 작업이 수집한 데이터 양, 실행 빈도, 성공률, 실행 시간 및 사용한 리소스를 검토할 수 있습니다. 결과는 일, 주 또는 월 단위로 그룹화할 수 있습니다. 날짜는 UTC 달력 일을 사용하며 날짜 범위는 최근 3개월 이내여야 합니다. `memberNames`를 생략하거나 비워 두면 결과가 현재 사용자로 제한됩니다. 지정한 구성원은 현재 사용자의 팀에 속해야 합니다. ## OpenAPI ````yaml /ko/api/openapi.json post /taskanalytics/queries openapi: 3.0.1 info: title: Octoparse API description: >- Octoparse OpenAPI를 사용하면 프로그래밍 방식으로 작업을 관리하고 클라우드 추출을 실행하며 수집된 데이터를 가져올 수 있습니다. 기본 URL: `https://openapi.octoparse.com` version: 1.0.0 servers: - url: https://openapi.octoparse.com description: Octoparse API 서버 security: [] paths: /taskanalytics/queries: post: tags: - Task summary: 작업 성능 분석 가져오기 description: >- **필수 플랜:** 스탠다드, 프로페셔널 또는 엔터프라이즈. 선택한 날짜 범위의 작업 수집 및 실행 지표를 가져옵니다. 이 엔드포인트를 사용하여 각 작업이 수집한 데이터 양, 실행 빈도, 성공률, 실행 시간 및 사용한 리소스를 검토할 수 있습니다. 결과는 일, 주 또는 월 단위로 그룹화할 수 있습니다. 날짜는 UTC 달력 일을 사용하며 날짜 범위는 최근 3개월 이내여야 합니다. `memberNames`를 생략하거나 비워 두면 결과가 현재 사용자로 제한됩니다. 지정한 구성원은 현재 사용자의 팀에 속해야 합니다. operationId: taskAnalyticsQueries requestBody: required: true content: application/json: schema: type: object required: - start - end properties: start: type: string format: date description: 시작일(포함, `yyyy-MM-dd` 형식)입니다. example: '2026-02-01' end: type: string format: date description: 종료일(포함)입니다. 현재 UTC 날짜 이후이거나 `start` 이전일 수 없습니다. example: '2026-04-01' page: type: integer minimum: 1 default: 1 description: 페이지 번호입니다. pageSize: type: integer minimum: 1 maximum: 100 default: 20 description: 페이지당 결과 수입니다. taskIds: type: array maxItems: 100 description: 포함할 작업 ID입니다. 모든 작업을 포함하려면 이 필드를 생략하세요. items: type: string memberNames: type: array maxItems: 100 description: 포함할 팀 구성원 이름입니다. 현재 사용자만 조회하려면 생략하거나 비워 두세요. items: type: string collectionMethod: type: string enum: - Cloud - Local - All default: All description: 클라우드 또는 로컬 추출로 필터링합니다. 둘 다 포함하려면 `All`을 사용하거나 이 필드를 생략하세요. timeGranularity: type: string enum: - Day - Week - Month default: Day description: 시간에 따라 결과를 그룹화하는 방식입니다. 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: 작업 분석을 반환했습니다. content: application/json: schema: type: object properties: data: type: object properties: total: type: integer description: 일치하는 총 행 수입니다. data: type: array description: 현재 페이지의 분석 레코드입니다. items: type: object properties: taskId: type: string description: 작업 ID입니다. userId: type: string description: 사용자 ID입니다. taskName: type: string nullable: true description: 작업 이름입니다. dayKey: type: string description: 이 레코드가 나타내는 날짜 구간입니다. weekStartDate: type: string format: date nullable: true description: '`timeGranularity`가 `Week`일 때의 주 시작일입니다.' weekEndDate: type: string format: date nullable: true description: '`timeGranularity`가 `Week`일 때의 주 종료일입니다.' collectionMethod: type: string enum: - Cloud - Local description: 추출 방식입니다. dataVolumeMetrics: type: object description: 수집된 데이터 양입니다. properties: totalCollected: type: number nullable: true description: 수집된 총 레코드 수입니다. deduplicatedVolume: type: number nullable: true description: 중복 제거 후 남은 레코드 수입니다. executionMetrics: type: object description: 작업 실행 결과 및 소요 시간입니다. properties: runCount: type: number nullable: true description: 총 실행 횟수입니다. successCount: type: number nullable: true description: 성공한 실행 수입니다. failureCount: type: number nullable: true description: 실패한 실행 수입니다. durationPerRunSeconds: type: number format: double nullable: true description: 실행당 평균 소요 시간(초)입니다. totalExecutionSeconds: type: number format: double nullable: true description: 총 실행 시간(초)입니다. successRate: type: number format: double minimum: 0 maximum: 1 nullable: true description: 0~1 값으로 나타낸 성공한 실행의 비율입니다. failureRate: type: number format: double minimum: 0 maximum: 1 nullable: true description: 0~1 값으로 나타낸 실패한 실행의 비율입니다. resourceUsageMetrics: type: object description: 작업 실행에서 사용한 리소스입니다. properties: captchaCount: type: number nullable: true description: 처리된 CAPTCHA 수입니다. simpleTemplateCount: type: number nullable: true description: 간단한 템플릿 사용량입니다. proxyIpCount: type: number format: double nullable: true description: 프록시 IP 사용량입니다. balance: type: number format: double nullable: true description: 리소스 비용입니다. requestId: type: string description: 요청 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: 요청 매개변수가 유효하지 않습니다. 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 ````