> 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/create-a-crawling-task-description.md).

# Create a crawling task description

### Basic Information

**Interface Description:** Create a crawling task for the Web Scraper API through the interface.

**Text request address:** <https://scraperapi.thordata.com/builder\\>
**YouTube audio/video request address:** <https://scraperapi.thordata.com/video\\_builder>

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

**Request parameters**

**Header：**

<table><thead><tr><th width="100">Parameter name</th><th width="100">Type</th><th width="100">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/api"><strong>Dashboard-MENU-My Account</strong></a> to view your token parameter value</td></tr><tr><td><code>Authorization</code></td><td>string</td><td>Yes</td><td>Please log in to the <a href="https://dashboard.thordata.com/web-scraper/details/3/api"><strong>Dashboard</strong></a> to view your Authorization token parameter value. Example: "Authorization: Bearer *********************"</td></tr></tbody></table>

**Body：**

<table><thead><tr><th width="100">Parameter name</th><th width="100">Type</th><th width="100">Required</th><th width="420.0703125">Describe</th></tr></thead><tbody><tr><td><code>spider_name</code></td><td>string</td><td>Yes</td><td><p>Facebook: </p><p><code>spider_name</code> facebook.com</p><p>Amazon: </p><p><code>spider_name</code> amazon.com</p><p>YouTube: </p><p><code>spider_name</code> youtube.com</p></td></tr><tr><td><code>spider_id</code></td><td>string</td><td>Yes</td><td><p>Amazon: </p><p><code>spider_id</code> amazon_product_by-url, amazon_product_by-best-sellers, etc.</p><p>YouTube: </p><p><code>spider_id</code> youtube_video_by-url, youtube_audio_by-url, etc.</p><p>For more ids, please see the <a href="https://doc.thordata.com/doc/scraping/web-scraper-api/parameter-description">parameter description</a>.</p></td></tr><tr><td><code>spider_parameters</code></td><td>text</td><td>Yes</td><td><p>Amazon: </p><p><code>url</code> crawling link, <code>zip_code</code> zip code, <code>sort_by</code> sorting method, etc. </p><p>YouTube: </p><p><code>url</code> crawling link. </p><p>For more parameters, please see the <a href="https://doc.thordata.com/doc/scraping/web-scraper-api/parameter-description">parameter description</a>.</p></td></tr><tr><td><code>spider_errors</code></td><td>string</td><td>Yes</td><td>true</td></tr><tr><td><code>file_name</code></td><td>string</td><td>Yes</td><td><p>Customize the name of the downloaded file. </p><p>{{TasksID}}, {{VideoID}}, etc. </p></td></tr></tbody></table>

### Response example

```sh
{
    "code": 200,
    "data": {
        "task_id": "68a21d2e8f2645e39f3d62231ef6d829"
    }
}
```

{% 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="158"> Parameter name</th><th width="102"> Type</th><th width="100">Required</th><th width="388.36328125">Describe</th></tr></thead><tbody><tr><td><code>code</code></td><td>number</td><td>Yes</td><td>The returned code value.</td></tr><tr><td><code>data</code></td><td>object</td><td>No</td><td>The returned details.</td></tr><tr><td>     <code>task_id</code></td><td>number</td><td>No</td><td>The id of the task.</td></tr></tbody></table>