> For the complete documentation index, see [llms.txt](https://doc.thordata.com/interface-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.thordata.com/interface-documentation/web-scraper-api/instructions-for-obtaining-the-task-list.md).

# Instructions for obtaining the task list

### Basic Information

**Interface Description:** Obtain Thordata Web Scraper API task list data through the interface

**Interface URL:** [**https://openapi.thordata.com/api/web-scraper-api/tasks-list**](https://openapi.thordata.com/api/web-scraper-api/tasks-list)

**Request Method:** <mark style="color:orange;">POST</mark>

**Request parameters**

**Header：**

<table><thead><tr><th width="136">Parameter name</th><th width="101">Type</th><th width="81">Required</th><th>Describe</th></tr></thead><tbody><tr><td><code>token</code></td><td>string</td><td>Yes</td><td>Please log in to the  <a href="https://dashboard.thordata.com/account-settings"><strong>Dashboard-MENU-My Account</strong></a> to view your token parameter value</td></tr></tbody></table>

**Body：**

<table><thead><tr><th width="135">Parameter name</th><th width="101">Type</th><th width="80">Required</th><th width="432.0703125">Describe</th></tr></thead><tbody><tr><td><code>page</code></td><td>text</td><td>No</td><td>Pagination</td></tr><tr><td><code>size</code></td><td>text</td><td>No</td><td>Quantity per page</td></tr></tbody></table>

### Response example

```sh
{
    "code": 200,
    "data": {
        "count": 124,
        "list": [
            {
                "task_id": "c33db1c4a1ce40a797e30d5bee6f55ea",
                "created_time": 1749435329,
                "end_time": 0,
                "prodect_id": 3,
                "url": "{\"spider_errors\":true,\"spider_id\":\"3\",\"spider_parameters\":[{\"url\":\"https://www.amazon.com/Best-Harold-Melvin-Blue-Notes/dp/B0045DO7XO\"}]}",
                "api_url": "",
                "api_code": 400,
                "api_result": "",
                "api_error_msg": "",
                "api_response_time": 75000,
                "success_rate": 0,
                "file_size": 0,
                "error_number": 1,
                "type": 0,
                "api_key": "5760ef945fcfb53a7a1594bb0e078ca5"
            },
            {
                "task_id": "d09fa949508d42bcba2e480bcf325524",
                "created_time": 1749434404,
                "end_time": 0,
                "prodect_id": 3,
                "url": "{\"spider_errors\":true,\"spider_id\":\"3\",\"spider_parameters\":[{\"url\":\"https://www.amazon.com/Best-Harold-Melvin-Blue-Notes/dp/B0045DO7XO\"}]}",
                "api_url": "",
                "api_code": 200,
                "api_result": "",
                "api_error_msg": "",
                "api_response_time": 10000,
                "success_rate": 1,
                "file_size": 0,
                "error_number": 0,
                "type": 0,
                "api_key": "5760ef945fcfb53a7a1594bb0e078ca5"
            }
        ]
    },
    "msg": "ok"
}
```

{% hint style="info" %}
If the returned code value is not 200, please check the [**error code description list**](https://doc.thordata.com/interface-documentation/error-code/error-code-description) and modify it.
{% endhint %}

<table><thead><tr><th width="196">Parameter name</th><th width="111">Type</th><th width="104">Required</th><th width="337.36328125">Describe</th></tr></thead><tbody><tr><td><code>code</code></td><td>number</td><td>No</td><td></td></tr><tr><td><code>data</code></td><td>object</td><td>No</td><td></td></tr><tr><td>     <code>count</code> </td><td>number</td><td>No</td><td></td></tr><tr><td>     <code>list</code></td><td>object []</td><td>No</td><td>item Type: object</td></tr><tr><td>        <code>task_id</code></td><td>string</td><td>Yes</td><td></td></tr><tr><td>        <code>created_time</code></td><td>number</td><td>Yes</td><td>   </td></tr><tr><td>        <code>end_time</code></td><td>number</td><td>Yes</td><td></td></tr><tr><td>        <code>prodect_id</code></td><td>number</td><td>Yes</td><td></td></tr><tr><td>        <code>url</code></td><td>string</td><td>Yes</td><td></td></tr><tr><td>        <code>api_url</code></td><td>string</td><td>Yes</td><td></td></tr><tr><td>        <code>api_code</code></td><td>number</td><td>Yes</td><td></td></tr><tr><td>        <code>api_result</code></td><td>string</td><td>Yes</td><td></td></tr><tr><td>        <code>api_error_msg</code></td><td>string</td><td>Yes</td><td></td></tr><tr><td>       <code>api_response_time</code></td><td>number</td><td>Yes</td><td></td></tr><tr><td>        <code>success_rate</code></td><td>number</td><td>Yes</td><td></td></tr><tr><td>        <code>file_size</code></td><td>number</td><td>Yes</td><td></td></tr><tr><td>        <code>error_number</code></td><td>number</td><td>Yes</td><td></td></tr><tr><td>        <code>type</code></td><td>number</td><td>Yes</td><td></td></tr><tr><td>        <code>api_key</code></td><td>string</td><td>Yes</td><td></td></tr><tr><td><code>msg</code></td><td>string</td><td>No</td><td></td></tr></tbody></table>