Skip to main content
GET
Search Tasks
The generated request and response examples are shown in the API panel. Use this page to understand the existing-task workflow.
Search existing Octoparse tasks before controlling or exporting them through AgentTools.
1

Find a task

Use keyword, status, or taskIds to locate existing tasks.
2

Read normalized status

Use taskStatusLabel for user-facing status and rawTaskStatusCode for lower-level diagnostics.
3

Continue the workflow

Use the returned taskId with startOrStopTask or exportData.

Required header

x-external-user-id is required for task search.

Status filters

Supported values are Running, Stopped, Completed, and Failed.
taskId identifies the task.taskName is the display name.taskDescription gives a short task summary when available.
page, size, total, and totalPages describe the result set.
Follow suggestedNextCall, workflow, and toolHint when deciding whether to call startOrStopTask or exportData.