> 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/tong-yong-zhua-qu-api.md).

# 通用抓取API

### 基礎信息

**接口說明：**&#x900F;過通用爬取API解鎖目標頁面。

**請求地址：**<https://universalapi.thordata.com/request>

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

### 請求參數

**Headers：**

<table><thead><tr><th width="130">參數名稱</th><th width="130">參數类型</th><th width="130"> 是否必須</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">Dashboard 帳戶</a>設定 以查看您的 token。</td></tr></tbody></table>

**Body：**

<table><thead><tr><th width="152">參數名稱</th><th width="130">參數类型</th><th width="130"> 是否必須</th><th width="358">描述</th></tr></thead><tbody><tr><td><code>url</code></td><td>string</td><td>是</td><td>該參數定義了用於爬取的搜索鏈接，默認值爲 google.com。您也可以更改爲其他搜索引擎鏈接。</td></tr><tr><td><code>js_render</code></td><td>string</td><td>否</td><td>參數支持動態內容、單頁應用(SPA)和複雜交互，建議開啓。</td></tr><tr><td><code>type</code></td><td>string</td><td>否</td><td>該參數定義了抓取結果的輸出格式。可選擇HTML和PNG格式，默認爲HTML。</td></tr><tr><td><code>block_resources</code></td><td>string</td><td>否</td><td>該參數可限止不必要的資源抓取，從而加快相應速度。</td></tr><tr><td><code>country</code></td><td>string</td><td>否</td><td>該參數定義了爬取時的代理使用哪個國家/地區，默認值無代理。</td></tr></tbody></table>

### 響應示例

```html
<html><head><meta name="color-scheme" content="light dark"><meta charset="utf-8"></head><body><pre>{
    "ip": "**.***.***.***",
    "city": "SantaClara",
    "region": "California",
    "country": "US",
    "loc": "**.3483,-**.9844",
    "org": "AS132203 Tencent Building, Kejizhongyi Avenue",
    "postal": "***",
    "asn": "AS132203",
    "timezone": "America/Los_Angeles"
}</pre><div class="json-formatter-container"></div></body></html>
```

| 參數名稱       | 參數类型   | Required |
| ---------- | ------ | -------- |
| `ip`       | string | 是        |
| `city`     | string | 是        |
| `region`   | string | 是        |
| `country`  | string | 是        |
| `loc`      | string | 是        |
| `org`      | string | 是        |
| `postal`   | string | 是        |
| `asn`      | string | 是        |
| `timezone` | string | 是        |
