Obtener analíticas de rendimiento de las tareas

curl --request POST \
  --url https://openapi.octoparse.com/taskanalytics/queries \
  --header 'Content-Type: application/json' \
  --data '
{
  "start": "2026-02-01",
  "end": "2026-04-01",
  "page": 1,
  "pageSize": 20,
  "timeGranularity": "Week",
  "collectionMethod": "All",
  "taskIds": [
    "task-id-1"
  ],
  "memberNames": []
}
'

import requests

url = "https://openapi.octoparse.com/taskanalytics/queries"

payload = {
    "start": "2026-02-01",
    "end": "2026-04-01",
    "page": 1,
    "pageSize": 20,
    "timeGranularity": "Week",
    "collectionMethod": "All",
    "taskIds": ["task-id-1"],
    "memberNames": []
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    start: '2026-02-01',
    end: '2026-04-01',
    page: 1,
    pageSize: 20,
    timeGranularity: 'Week',
    collectionMethod: 'All',
    taskIds: ['task-id-1'],
    memberNames: []
  })
};

fetch('https://openapi.octoparse.com/taskanalytics/queries', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://openapi.octoparse.com/taskanalytics/queries",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'start' => '2026-02-01',
    'end' => '2026-04-01',
    'page' => 1,
    'pageSize' => 20,
    'timeGranularity' => 'Week',
    'collectionMethod' => 'All',
    'taskIds' => [
        'task-id-1'
    ],
    'memberNames' => [
        
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://openapi.octoparse.com/taskanalytics/queries"

	payload := strings.NewReader("{\n  \"start\": \"2026-02-01\",\n  \"end\": \"2026-04-01\",\n  \"page\": 1,\n  \"pageSize\": 20,\n  \"timeGranularity\": \"Week\",\n  \"collectionMethod\": \"All\",\n  \"taskIds\": [\n    \"task-id-1\"\n  ],\n  \"memberNames\": []\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://openapi.octoparse.com/taskanalytics/queries")
  .header("Content-Type", "application/json")
  .body("{\n  \"start\": \"2026-02-01\",\n  \"end\": \"2026-04-01\",\n  \"page\": 1,\n  \"pageSize\": 20,\n  \"timeGranularity\": \"Week\",\n  \"collectionMethod\": \"All\",\n  \"taskIds\": [\n    \"task-id-1\"\n  ],\n  \"memberNames\": []\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://openapi.octoparse.com/taskanalytics/queries")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"start\": \"2026-02-01\",\n  \"end\": \"2026-04-01\",\n  \"page\": 1,\n  \"pageSize\": 20,\n  \"timeGranularity\": \"Week\",\n  \"collectionMethod\": \"All\",\n  \"taskIds\": [\n    \"task-id-1\"\n  ],\n  \"memberNames\": []\n}"

response = http.request(request)
puts response.read_body

{
  "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"
}

{
  "error": {
    "code": 123,
    "message": "<string>"
  },
  "requestId": "<string>"
}

Tarea

Obtener analíticas de rendimiento de las tareas

Plan requerido: Plan Estándar, Plan Profesional o Plan Empresarial.

Recupera las métricas de recopilación y ejecución de tareas para un intervalo de fechas seleccionado. Usa este endpoint para revisar cuántos datos recopiló cada tarea, con qué frecuencia se ejecutó, su tasa de éxito y tiempo de ejecución, y los recursos que consumió. Los resultados pueden agruparse por día, semana o mes.

Las fechas usan días naturales en UTC y el intervalo debe estar comprendido dentro de los últimos tres meses. Si memberNames se omite o está vacío, los resultados se limitan al usuario actual; los miembros especificados deben pertenecer al equipo del usuario actual.

POST

taskanalytics

queries

Obtener analíticas de rendimiento de las tareas

curl --request POST \
  --url https://openapi.octoparse.com/taskanalytics/queries \
  --header 'Content-Type: application/json' \
  --data '
{
  "start": "2026-02-01",
  "end": "2026-04-01",
  "page": 1,
  "pageSize": 20,
  "timeGranularity": "Week",
  "collectionMethod": "All",
  "taskIds": [
    "task-id-1"
  ],
  "memberNames": []
}
'

import requests

url = "https://openapi.octoparse.com/taskanalytics/queries"

payload = {
    "start": "2026-02-01",
    "end": "2026-04-01",
    "page": 1,
    "pageSize": 20,
    "timeGranularity": "Week",
    "collectionMethod": "All",
    "taskIds": ["task-id-1"],
    "memberNames": []
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    start: '2026-02-01',
    end: '2026-04-01',
    page: 1,
    pageSize: 20,
    timeGranularity: 'Week',
    collectionMethod: 'All',
    taskIds: ['task-id-1'],
    memberNames: []
  })
};

fetch('https://openapi.octoparse.com/taskanalytics/queries', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://openapi.octoparse.com/taskanalytics/queries",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'start' => '2026-02-01',
    'end' => '2026-04-01',
    'page' => 1,
    'pageSize' => 20,
    'timeGranularity' => 'Week',
    'collectionMethod' => 'All',
    'taskIds' => [
        'task-id-1'
    ],
    'memberNames' => [
        
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://openapi.octoparse.com/taskanalytics/queries"

	payload := strings.NewReader("{\n  \"start\": \"2026-02-01\",\n  \"end\": \"2026-04-01\",\n  \"page\": 1,\n  \"pageSize\": 20,\n  \"timeGranularity\": \"Week\",\n  \"collectionMethod\": \"All\",\n  \"taskIds\": [\n    \"task-id-1\"\n  ],\n  \"memberNames\": []\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://openapi.octoparse.com/taskanalytics/queries")
  .header("Content-Type", "application/json")
  .body("{\n  \"start\": \"2026-02-01\",\n  \"end\": \"2026-04-01\",\n  \"page\": 1,\n  \"pageSize\": 20,\n  \"timeGranularity\": \"Week\",\n  \"collectionMethod\": \"All\",\n  \"taskIds\": [\n    \"task-id-1\"\n  ],\n  \"memberNames\": []\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://openapi.octoparse.com/taskanalytics/queries")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"start\": \"2026-02-01\",\n  \"end\": \"2026-04-01\",\n  \"page\": 1,\n  \"pageSize\": 20,\n  \"timeGranularity\": \"Week\",\n  \"collectionMethod\": \"All\",\n  \"taskIds\": [\n    \"task-id-1\"\n  ],\n  \"memberNames\": []\n}"

response = http.request(request)
puts response.read_body

{
  "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"
}

{
  "error": {
    "code": 123,
    "message": "<string>"
  },
  "requestId": "<string>"
}

Cuerpo

application/json

start

string<date>

requerido

Fecha de inicio (incluida) con el formato yyyy-MM-dd.

Ejemplo:

"2026-02-01"

end

string<date>

requerido

Fecha de finalización (incluida). No puede ser posterior a la fecha UTC actual ni anterior a start.

Ejemplo:

"2026-04-01"

page

integer

predeterminado:1

Número de página.

Rango requerido: x >= 1

pageSize

integer

predeterminado:20

Número de resultados por página.

Rango requerido: 1 <= x <= 100

taskIds

string[]

ID de las tareas que se incluirán. Omite este campo para incluir todas las tareas.

Maximum array length: 100

memberNames

string[]

Nombres de los miembros del equipo que se incluirán. Omite el campo o déjalo vacío para consultar solo al usuario actual.

Maximum array length: 100

collectionMethod

enum<string>

predeterminado:All

Filtra por extracción local o en la nube. Usa All u omite este campo para incluir ambas.

Opciones disponibles:

Cloud,

Local,

All

timeGranularity

enum<string>

predeterminado:Day

Cómo se agrupan los resultados a lo largo del tiempo.

Opciones disponibles:

Day,

Week,

Month

Respuesta

Las analíticas de las tareas se devolvieron correctamente.

data

object

Show child attributes

requestId

string

ID de la solicitud.