> 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 | 是        |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://doc.thordata.com/interface-documentation/zh-hk/tong-yong-zhua-qu-api.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
