> 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/zh-hk/web-scraper-api/ren-wu-lie-biao-huo-qu-shuo-ming.md).

# 任務列表获取說明

### 基礎信息

**接口說明：**通過接口獲取 Thordata Web Scraper API 任務列表數據

**請求地址：**[**https://openapi.thordata.com/api/web-scraper-api/tasks-list**](https://openapi.thordata.com/api/web-scraper-api/tasks-list)

**請求方式：**<mark style="color:orange;">POST</mark>

### 請求參數

**Headers：**

<table><thead><tr><th width="89">參數名稱</th><th width="85">參數类型</th><th width="82">是否必須</th><th>描述</th></tr></thead><tbody><tr><td><code>token</code></td><td>string</td><td>必須</td><td>請登入<a href="https://dashboard.thordata.com/account-settings"><strong>儀表板 >> 菜單 >> 我的賬戶</strong></a>查看您的token參數值</td></tr></tbody></table>

**Body:**

<table><thead><tr><th width="85">參數名稱</th><th width="85">參數类型</th><th width="86">是否必須</th><th width="491.36328125">描述</th></tr></thead><tbody><tr><td><code>page</code></td><td>text</td><td>否</td><td>分頁</td></tr><tr><td><code>size</code></td><td>text</td><td>否</td><td>每頁數量</td></tr></tbody></table>

### 響應示例

```json
{
    "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" %}
若返回的code值非200，請查閱[**錯誤碼說明**](/interface-documentation/zh-hk/cuo-wu-ma/cuo-wu-ma-shuo-ming.md)列表並進行修改
{% endhint %}

<table><thead><tr><th width="206">參數名稱</th><th width="119">參數类型</th><th width="104">是否必須</th><th width="319.36328125">描述</th></tr></thead><tbody><tr><td>code</td><td>number</td><td>否</td><td></td></tr><tr><td>data</td><td>object</td><td>否</td><td></td></tr><tr><td>     count </td><td>number</td><td>否</td><td></td></tr><tr><td>     list</td><td>object []</td><td>否</td><td>item 類型: object</td></tr><tr><td>        task_id</td><td>string</td><td>必須</td><td></td></tr><tr><td>        created_time</td><td>number</td><td>必須</td><td>   </td></tr><tr><td>        end_time</td><td>number</td><td>必須</td><td></td></tr><tr><td>        prodect_id</td><td>number</td><td>必須</td><td></td></tr><tr><td>        url</td><td>string</td><td>必須</td><td></td></tr><tr><td>        api_url</td><td>string</td><td>必須</td><td></td></tr><tr><td>        api_code</td><td>number</td><td>必須</td><td></td></tr><tr><td>        api_result</td><td>string</td><td>必須</td><td></td></tr><tr><td>        api_error_msg</td><td>string</td><td>必須</td><td></td></tr><tr><td>       api_response_time</td><td>number</td><td>必須</td><td></td></tr><tr><td>        success_rate</td><td>number</td><td>必須</td><td></td></tr><tr><td>        file_size</td><td>number</td><td>必須</td><td></td></tr><tr><td>        error_number</td><td>number</td><td>必須</td><td></td></tr><tr><td>        type</td><td>number</td><td>必須</td><td></td></tr><tr><td>        api_key</td><td>string</td><td>必須</td><td></td></tr><tr><td>msg</td><td>string</td><td>否</td><td></td></tr></tbody></table>