> For the complete documentation index, see [llms.txt](https://doc.thordata.com/doc/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/doc/zh/pa-qu/web-unlocker/can-shu-shuo-ming.md).

# 参数说明

了解 Thordata 的 网页解锁器 - 抓取参数。

**`Token`（必填）：**

该参数定义了爬取时使用的 API 令牌。对于您的成功爬取起到决定性作用。

<table><thead><tr><th width="66">参数</th><th width="114">名称</th><th width="237">作用</th></tr></thead><tbody><tr><td>token</td><td>Token</td><td>爬取时验证的 API 令牌</td></tr></tbody></table>

**`URL`（必填）：**

该参数定义了爬取的目的网站链接，默认值为 google.com。您也可以更改为其他搜索引擎链接。

<table><thead><tr><th width="66">参数</th><th width="114">名称</th><th width="237">作用</th></tr></thead><tbody><tr><td>url</td><td>URL</td><td>爬取的目的网站的链接</td></tr></tbody></table>

**示例请求：**

带有`token`:<mark style="color:blue;">Token ,</mark>`url`:<mark style="color:blue;"><https://www.google.com></mark> 的参数示例

```sh
curl -X POST https://webunlocker.thordata.com/request -H "Authorization: Bearer Token" -H "Content-Type: application/x-www-form-urlencoded" -d "url=https://www.google.com" -d "type=html" -d "js_render=True"
```

<details>

<summary><code>js_render</code> <strong>，</strong>JS渲染<strong>(非必填)</strong></summary>

JS渲染能够处理动态加载的内容和单页应用(SPA)，支持更交互复杂的页面和渲染需求，建议您开启。

`js_render`=True

`js_render`=False

**示例请求：**

带有 `js_render`:<mark style="color:blue;">True</mark> 的参数示例

```sh
curl -X POST https://webunlocker.thordata.com/request -H "Authorization: Bearer Token" -H "Content-Type: application/x-www-form-urlencoded" -d "url=https://www.google.com" -d "type=html" -d "js_render=True"
```

</details>

<details>

<summary><code>type</code> <strong>，</strong>输出格式<strong>(非必填)</strong></summary>

该参数定义了抓取结果的输出格式。可选择HTML和PNG格式，默认为HTML。

`format`=HTML

`format`=PNG

**示例请求：**

带有 `type`:<mark style="color:blue;">png</mark> 的参数示例

```sh
curl -X POST https://webunlocker.thordata.com/request -H "Authorization: Bearer Token" -H "Content-Type: application/x-www-form-urlencoded" -d "url=https://www.google.com" -d "type=png" -d "js_render=True"
```

</details>

<details>

<summary><code>block_resources</code><strong>，</strong>阻止<strong>(非必填)</strong></summary>

该参数可限止不必要的资源抓取，从而加快抓取速度。

`block_resources`=图片

`block_resources`=Javascript脚本

**示例请求：**

带有`block_resources`:<mark style="color:blue;">script</mark> 的参数示例

```sh
curl -X POST https://webunlocker.thordata.com/request -H "Authorization: Bearer Token" -H "Content-Type: application/x-www-form-urlencoded" -d "url=https://www.google.com" -d "type=html" -d "js_render=True" -d "block_resources=script"
```

</details>

<details>

<summary><code>country</code><strong>，代理(非必填)</strong></summary>

该参数定义了爬取时的代理使用哪个国家/地区，默认值无代理。

`country`=随机

`country`=任意国家代码

**示例请求：**

带有 `country`:<mark style="color:blue;">al</mark> 的参数示例

```sh
curl -X POST https://webunlocker.thordata.com/request -H "Authorization: Bearer Token" -H "Content-Type: application/x-www-form-urlencoded" -d "url=https://www.google.com" -d "type=html" -d "js_render=True" -d "country=al"
```

</details>

<details>

<summary><code>clean_content</code><strong>，清除(非必填)</strong></summary>

此参数用于从返回结果中删除 `JS` 和 `CSS` 内容。

**示例请求：**

带有 `clean_content`: `JS` 和 `CSS` 的参数示例

```sh
curl -X POST https://webunlocker.thordata.com/request \
 -H "Authorization: Bearer token" \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -d "url=https://www.google.com" \
 -d "type=html" \
 -d "js_render=True" \
 -d "clean_content=js,css" \
 -d "header=False"
```

</details>

<details>

<summary><code>wait</code><strong>，等待（毫秒）(非必填)</strong></summary>

等待页面在指定时间内加载内容（以毫秒为单位）。最大值：100,000 毫秒（100 秒）

**示例请求：**

带有`wait`:<mark style="color:blue;">1000</mark>的参数示例

```sh
curl -X POST https://webunlocker.thordata.com/request \
 -H "Authorization: Bearer token" \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -d "url=https://www.google.com" \
 -d "type=html" \
 -d "js_render=True" \
 -d "wait=10000"
```

</details>

<details>

<summary><code>wait_for</code> <strong>，等待选择器(非必填)</strong></summary>

等待 CSS 選擇器在 DOM 中載入，若同時使用 `wait_for` 和 `wait`，則以 `wait_for` 為優先（覆蓋固定時間）。指定元素最長等待 30 秒，超時後會自動返回網站內容。

**示例请求：**

带有帶有 `wait_for:1000` 的參數示例

```sh
curl -X POST https://webunlocker.thordata.com/request \
 -H "Authorization: Bearer token" \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -d "url=https://www.google.com" \
 -d "type=html" \
 -d "js_render=True" \
 -d "wait=10000" \
 -d "wait_for=.content"
```

</details>

<details>

<summary><code>headers</code><strong>，自定义headers(非必填)</strong></summary>

向目标网站传递自定义请求头，多个 headers 时请用英文逗号‘,’分隔；
\
HTTP标头是键值对，以冒号 (:) 分隔。发送的参数应采用 JSON 格式。

**示例请求：**

如果您想发送 `User-Agent` 和 `Content-Type`，则应如下所示：

```sh
curl -X POST https://webunlocker.thordata.com/request \
 -H "Authorization: Bearer token" \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -d "url=https://www.google.com" \
 -d "type=html" \
 -d "js_render=token" \
 -d 'headers=[{"name":"name1","value":"value1"}]' \
 -d 'cookies=[{"name":"name2","value":"value2"}]'
```

</details>

<details>

<summary><code>cookies</code><strong>，</strong>Cookies<strong>(非必填)</strong></summary>

将自定义 `cookie` 传递给目标网站，多个 `cookies` 时请用英文分号‘;’分隔。

&#x20;`cookie`是网站通过网络浏览器存储在用户设备上的小块数据。

`cookie`允许网站保留用户信息，例如登录状态、偏好设置或追踪详情，从而改善和个性化浏览体验。&#x20;

发出请求时，您可以通过两种方式添加 `cookie` :

在 `headers` 参数中：（例如：{"`"Cookie`":"`cookie_name_1=cookie_value_1`"}）

直接使用cookies: （例如：{"`"Cookie`":"`cookie_name_1=cookie_value_1`"}）

**示例请求：**

使用此专用cookies参数：以以下格式直接传递它们： `cookie_name_1=cookie_value_1; cookie_name_2=cookie_value_2`

```sh
curl -X POST https://webunlocker.thordata.com/request \
 -H "Authorization: Bearer token" \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -d "url=https://www.google.com" \
 -d "type=html" \
 -d "js_render=token" \
 -d 'headers=[{"name":"name1","value":"value1"}]' \
 -d 'cookies=[{"name":"name2","value":"value2"}]'
```

</details>