TOOL API

execute_task

Start an Octoparse cloud task from `templateName` + `parameters` (JSON object string keyed by `inputSchema[].field`). Preflight runs automatically and returns actionable input errors without creating a task when input is incomplete. Prefer a unique `taskName` for recovery via `search_tasks`. The call waits up to 45 seconds and returns the Octoparse task id (`taskId`), `lotNo`, `collectedRows`, and status `running`, `completed`, or `stopped`. collectedRows defaults to 0; use status to distinguish a running task with no rows yet from a terminal task with no rows. If a failure result includes `taskId`, call `get_task_status(taskId)`; do not call `execute_task` again. A `progressToken` adds progress notifications. Input/Dropdown=string; MultiInput/CheckboxList=string[].

devOAuth1 credits

Call information

Tool slug
bazhuayu.execute_task
Provider
Octoparse Collection
Average response
0 ms
Calls in 7 days
0

Input parameters

templateNamerequired

Template name from search_templates. Prefer exact `template.templateName` or a high-`score` `templates[].templateName` from semantic results.

taskName

Optional unique friendly task name. Strongly recommended for long-running jobs because the same run can be recovered with search_tasks(keyword=taskName) if the client times out before you capture the returned Octoparse taskId.

parameters

Business parameters as a JSON object string. Use `inputSchema[].field` as keys. For source-backed fields, read root options from exact `search_templates` `sourceTree` and pass selected option `key` values. If a dependent selection is still required, execute_task returns input_required with the next sourceOptions; add that selection and call execute_task again. Input/Dropdown = string; MultiInput = string[]; CheckboxList = string[] even for one value. Example: "{"site":"United States","confirm_your_site":["https://www.amazon.com/"],"keywords":["wireless earbuds"],"number_of_pages_to_scrape":"1"}"