> 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-hk/web-scraper-api/zhua-qu-can-shu-shuo-ming/zillow-zhua-qu-can-shu.md).

# Zillow 抓取參數

Web Scraper API Zillow 抓取參數\
使用 Thordata 的 Web Scraper API 設定 Zillow 抓取參數，包括Zillow URL、地點關鍵字、清單類別、主頁類型、在Zillow上的日子、最多數量等參數。

唯一識別：

<details>

<summary><code>token</code> <strong>，訪問令牌（必填）</strong></summary>

該參數用於確保爬取請求合法性的 API 訪問令牌。

**請求示例：**

`"Authorization: Bearer ********************************"`

```sh
curl -X POST "https://scraperapi.thordata.com/builder" ^
  -H "Authorization: Bearer ********************" ^
  -H "Content-Type: application/x-www-form-urlencoded" ^
  -d "spider_name=www.zillow.com" ^
  -d "spider_id=zillow_product_by-url" ^
  -d "spider_parameters=[{\"url\": \"https://www.zillow.com/homedetails/2506-Gordon-Cir-South-Bend-IN-46635/77050198_zpid/?t=for_sale\"}]" ^
  -d "spider_errors=true" ^
  -d "file_name={{TasksID}}"
```

</details>

一、產品-抓取房產詳情信息：\
1\.  Zillow-透過URL抓取房產詳情信息

<details>

<summary><code>spider_id</code> ，<strong>所屬抓取工具（必填）</strong></summary>

定義了使用哪個抓取工具。

**請求示例：**

`spider_id=zillow_product_by-url`

```sh
curl -X POST "https://scraperapi.thordata.com/builder" ^
  -H "Authorization: Bearer Token-ID" ^
  -H "Content-Type: application/x-www-form-urlencoded" ^
  -d "spider_name=www.zillow.com" ^
  -d "spider_id=zillow_product_by-url" ^
  -d "spider_parameters=[{\"url\": \"https://www.zillow.com/homedetails/2506-Gordon-Cir-South-Bend-IN-46635/77050198_zpid/?t=for_sale\"}]" ^
  -d "spider_errors=true" ^
  -d "file_name={{TasksID}}"
```

</details>

<details>

<summary><code>url</code> ， <strong>Zillow URL（必填）</strong></summary>

此參數用於指定待抓取的 Zillow 房產詳情鏈接。

**請求示例：**

`"url": "https://www.zillow.com/homedetails/2506-Gordon-Cir-South-Bend-IN-46635/77050198_zpid/?t=for_sale"`&#x20;

```sh
curl -X POST "https://scraperapi.thordata.com/builder" ^
  -H "Authorization: Bearer Token-ID" ^
  -H "Content-Type: application/x-www-form-urlencoded" ^
  -d "spider_name=www.zillow.com" ^
  -d "spider_id=zillow_product_by-url" ^
  -d "spider_parameters=[{\"url\": \"https://www.zillow.com/homedetails/2506-Gordon-Cir-South-Bend-IN-46635/77050198_zpid/?t=for_sale\"}]" ^
  -d "spider_errors=true" ^
  -d "file_name={{TasksID}}"
```

</details>

2. Zillow-透過輸入過濾器抓取房產詳細信息

<details>

<summary><code>spider_id</code> ，<strong>所屬抓取工具（必填）</strong></summary>

定義了使用哪個抓取工具。

**請求示例：**

```sh
curl -X POST "https://scraperapi.thordata.com/builder" ^
  -H "Authorization: Bearer Token-ID" ^
  -H "Content-Type: application/x-www-form-urlencoded" ^
  -d "spider_name=www.zillow.com" ^
  -d "spider_id=zillow_product_by-filter" ^
  -d "spider_parameters=[{\"keywords-location\": \"14850\",\"listingCategory\": \"For Rent\",\"HomeType\": \"Houses\",\"days_on_zillow\": \"Any\",\"maximum\": \"10\"}]" ^
  -d "spider_errors=true" ^
  -d "file_name={{TasksID}}"
```

</details>

<details>

<summary><code>keywords-location</code> ， <strong>地點關鍵字（必填）</strong></summary>

此參數用於指定 Zillow 搜尋頁面的搜尋地址訊息，可以是郵遞區號、具體城市或地址。

**請求示例：**

`"keywords-location": "14850"`

```sh
curl -X POST "https://scraperapi.thordata.com/builder" ^
  -H "Authorization: Bearer Token-ID" ^
  -H "Content-Type: application/x-www-form-urlencoded" ^
  -d "spider_name=www.zillow.com" ^
  -d "spider_id=zillow_product_by-filter" ^
  -d "spider_parameters=[{\"keywords-location\": \"14850\",\"listingCategory\": \"For Rent\",\"HomeType\": \"Houses\",\"days_on_zillow\": \"Any\",\"maximum\": \"10\"}]" ^
  -d "spider_errors=true" ^
  -d "file_name={{TasksID}}"
```

</details>

<details>

<summary><code>listingCategory</code> ， <strong>列表類別（可選）</strong></summary>

此參數用於指定 Zillow 搜尋房產類別的參數，包括已售出、出租、出售。\
參數值：`Sold` ，`For Rent` ，`For Sale`

**請求示例：**

`"listingCategory": "For Rent"`

```sh
curl -X POST "https://scraperapi.thordata.com/builder" ^
  -H "Authorization: Bearer Token-ID" ^
  -H "Content-Type: application/x-www-form-urlencoded" ^
  -d "spider_name=www.zillow.com" ^
  -d "spider_id=zillow_product_by-filter" ^
  -d "spider_parameters=[{\"keywords-location\": \"14850\",\"listingCategory\": \"For Rent\",\"HomeType\": \"Houses\",\"days_on_zillow\": \"Any\",\"maximum\": \"10\"}]" ^
  -d "spider_errors=true" ^
  -d "file_name={{TasksID}}"
```

</details>

<details>

<summary><code>HomeType</code> ，<strong>主頁類型（可選）</strong></summary>

此參數用於指定 Zillow 搜尋房產主頁類型的參數，包括獨棟別墅、聯排別墅、多戶住宅、公寓/合作公寓、地塊/土地、公寓、預製房屋。\
參數值：`Houses`&#x20;`Townhomes`&#x20;`Multi-family`&#x20;`Condos/Co-ops`&#x20;`Lots/Land` `Apartments`&#x20;`Manufactured`

**請求示例：**

"HomeType": "Houses"

```sh
curl -X POST "https://scraperapi.thordata.com/builder" ^
  -H "Authorization: Bearer Token-ID" ^
  -H "Content-Type: application/x-www-form-urlencoded" ^
  -d "spider_name=www.zillow.com" ^
  -d "spider_id=zillow_product_by-filter" ^
  -d "spider_parameters=[{\"keywords-location\": \"14850\",\"listingCategory\": \"For Rent\",\"HomeType\": \"Houses\",\"days_on_zillow\": \"Any\",\"maximum\": \"10\"}]" ^
  -d "spider_errors=true" ^
  -d "file_name={{TasksID}}"
```

</details>

<details>

<summary><code>days_on_zillow</code> ，<strong>在zillow上的日子（可選）</strong></summary>

此參數用於指定抓取發佈在 Zillow 網站多久時長的房屋。\
參數值：`Any` `1 day` `7 days` `14 days` `30 days` `90 days` `6 months` `12 months` `24 months` `36 months`

**請求示例：**

`"days_on_zillow": "Any"`

```sh
curl -X POST "https://scraperapi.thordata.com/builder" ^
  -H "Authorization: Bearer Token-ID" ^
  -H "Content-Type: application/x-www-form-urlencoded" ^
  -d "spider_name=www.zillow.com" ^
  -d "spider_id=zillow_product_by-filter" ^
  -d "spider_parameters=[{\"keywords-location\": \"14850\",\"listingCategory\": \"For Rent\",\"HomeType\": \"Houses\",\"days_on_zillow\": \"Any\",\"maximum\": \"10\"}]" ^
  -d "spider_errors=true" ^
  -d "file_name={{TasksID}}"
```

</details>

<details>

<summary><code>maximum</code> ，<strong>最大數量（必填）</strong></summary>

此參數用於指定抓取 Zillow 房產資訊的最大數量。

**請求示例：**

`"maximum": "10"`

```sh
curl -X POST "https://scraperapi.thordata.com/builder" ^
  -H "Authorization: Bearer Token-ID" ^
  -H "Content-Type: application/x-www-form-urlencoded" ^
  -d "spider_name=www.zillow.com" ^
  -d "spider_id=zillow_product_by-filter" ^
  -d "spider_parameters=[{\"keywords-location\": \"14850\",\"listingCategory\": \"For Rent\",\"HomeType\": \"Houses\",\"days_on_zillow\": \"Any\",\"maximum\": \"10\"}]" ^
  -d "spider_errors=true" ^
  -d "file_name={{TasksID}}"
```

</details>

3. Zillow-透過輸入清單網址抓取房產詳情信息

<details>

<summary><code>spider_id</code> ，<strong>所屬抓取工具（必填）</strong></summary>

定義了使用哪個抓取工具。

**請求示例：**

`spider_id=zillow_product_by-listurl`

```sh
curl -X POST "https://scraperapi.thordata.com/builder" ^
  -H "Authorization: Bearer Token-ID" ^
  -H "Content-Type: application/x-www-form-urlencoded" ^
  -d "spider_name=www.zillow.com" ^
  -d "spider_id=zillow_product_by-listurl" ^
  -d "spider_parameters=[{\"listurl\": \"https://www.zillow.com/south-bend-in/?searchQueryState=%7B%22pagination%22%3A%7B%7D%2C%22isMapVisible%22%3Atrue%2C%22mapBounds%22%3A%7B%22west%22%3A-86.28027395481374%2C%22east%22%3A-86.21281103367116%2C%22south%22%3A41.6786743836223%2C%22north%22%3A41.717895122883554%7D%2C%22regionSelection%22%3A%5B%7B%22regionId%22%3A20555%2C%22regionType%22%3A6%7D%5D%2C%22filterState%22%3A%7B%22sort%22%3A%7B%22value%22%3A%22globalrelevanceex%22%7D%2C%22ah%22%3A%7B%22value%22%3Atrue%7D%7D%2C%22isEntirePlaceForRent%22%3Atrue%2C%22isRoomForRent%22%3Afalse%2C%22isListVisible%22%3Atrue%2C%22mapZoom%22%3A14%7D\",\"maximum\": \"10\"}]" ^
  -d "spider_errors=true" ^
  -d "file_name={{TasksID}}"
```

</details>

<details>

<summary><code>listurl</code> ，<strong>列表網站（必填）</strong></summary>

此參數用於指定待抓取的 Zillow 房產清單鏈接。

**請求示例：**

`"listurl": "https://www.zillow.com/south-bend-in/?searchQueryState=%7B%22pagination%22%3A%7B%7D%2C%22isMapVisible%22%3Atrue%2C%22mapBounds%22%3A%7B%22west%22%3A-86.28027395481374%2C%22east%22%3A-86.21281103367116%2C%22south%22%3A41.6786743836223%2C%22north%22%3A41.717895122883554%7D%2C%22regionSelection%22%3A%5B%7B%22regionId%22%3A20555%2C%22regionType%22%3A6%7D%5D%2C%22filterState%22%3A%7B%22sort%22%3A%7B%22value%22%3A%22globalrelevanceex%22%7D%2C%22ah%22%3A%7B%22value%22%3Atrue%7D%7D%2C%22isEntirePlaceForRent%22%3Atrue%2C%22isRoomForRent%22%3Afalse%2C%22isListVisible%22%3Atrue%2C%22mapZoom%22%3A14%7D"`

```sh
curl -X POST "https://scraperapi.thordata.com/builder" ^
  -H "Authorization: Bearer Token-ID" ^
  -H "Content-Type: application/x-www-form-urlencoded" ^
  -d "spider_name=www.zillow.com" ^
  -d "spider_id=zillow_product_by-listurl" ^
  -d "spider_parameters=[{\"listurl\": \"https://www.zillow.com/south-bend-in/?searchQueryState=%7B%22pagination%22%3A%7B%7D%2C%22isMapVisible%22%3Atrue%2C%22mapBounds%22%3A%7B%22west%22%3A-86.28027395481374%2C%22east%22%3A-86.21281103367116%2C%22south%22%3A41.6786743836223%2C%22north%22%3A41.717895122883554%7D%2C%22regionSelection%22%3A%5B%7B%22regionId%22%3A20555%2C%22regionType%22%3A6%7D%5D%2C%22filterState%22%3A%7B%22sort%22%3A%7B%22value%22%3A%22globalrelevanceex%22%7D%2C%22ah%22%3A%7B%22value%22%3Atrue%7D%7D%2C%22isEntirePlaceForRent%22%3Atrue%2C%22isRoomForRent%22%3Afalse%2C%22isListVisible%22%3Atrue%2C%22mapZoom%22%3A14%7D\",\"maximum\": \"10\"}]" ^
  -d "spider_errors=true" ^
  -d "file_name={{TasksID}}"
```

</details>

<details>

<summary><code>maximum</code> ，<strong>最大數量（必填）</strong></summary>

此參數用於指定抓取 Zillow 房產資訊的最大數量。

**請求示例：**

`"maximum": "10"`

```sh
curl -X POST "https://scraperapi.thordata.com/builder" ^
  -H "Authorization: Bearer Token-ID" ^
  -H "Content-Type: application/x-www-form-urlencoded" ^
  -d "spider_name=www.zillow.com" ^
  -d "spider_id=zillow_product_by-listurl" ^
  -d "spider_parameters=[{\"listurl\": \"https://www.zillow.com/south-bend-in/?searchQueryState=%7B%22pagination%22%3A%7B%7D%2C%22isMapVisible%22%3Atrue%2C%22mapBounds%22%3A%7B%22west%22%3A-86.28027395481374%2C%22east%22%3A-86.21281103367116%2C%22south%22%3A41.6786743836223%2C%22north%22%3A41.717895122883554%7D%2C%22regionSelection%22%3A%5B%7B%22regionId%22%3A20555%2C%22regionType%22%3A6%7D%5D%2C%22filterState%22%3A%7B%22sort%22%3A%7B%22value%22%3A%22globalrelevanceex%22%7D%2C%22ah%22%3A%7B%22value%22%3Atrue%7D%7D%2C%22isEntirePlaceForRent%22%3Atrue%2C%22isRoomForRent%22%3Afalse%2C%22isListVisible%22%3Atrue%2C%22mapZoom%22%3A14%7D\",\"maximum\": \"10\"}]" ^
  -d "spider_errors=true" ^
  -d "file_name={{TasksID}}"
```

</details>

**二、產品-抓取房產價格歷史信息：**

&#x20;1\.  Zillow-透過URL抓取價格歷史信息

<details>

<summary><code>spider_id</code> ，<strong>所屬抓取工具（必填）</strong></summary>

定義了使用哪個抓取工具。

**請求示例：**

`spider_id=zillow_price_by-url`

```sh
curl -X POST "https://scraperapi.thordata.com/builder" ^
  -H "Authorization: Bearer Token-ID" ^
  -H "Content-Type: application/x-www-form-urlencoded" ^
  -d "spider_name=www.zillow.com" ^
  -d "spider_id=zillow_price_by-url" ^
  -d "spider_parameters=[{\"url\": \"https://www.zillow.com/homedetails/2506-Gordon-Cir-South-Bend-IN-46635/77050198_zpid/?t=for_sale\"}]" ^
  -d "spider_errors=true" ^
  -d "file_name={{TasksID}}"
```

</details>

<details>

<summary><code>url</code> ， <strong>Zillow URL（必填）</strong></summary>

此參數用於指定待抓取的 Zillow 房產詳情鏈接。

**請求示例：**

`"url": "https://www.zillow.com/homedetails/2506-Gordon-Cir-South-Bend-IN-46635/77050198_zpid/?t=for_sale"`

```sh
curl -X POST "https://scraperapi.thordata.com/builder" ^
  -H "Authorization: Bearer Token-ID" ^
  -H "Content-Type: application/x-www-form-urlencoded" ^
  -d "spider_name=www.zillow.com" ^
  -d "spider_id=zillow_price_by-url" ^
  -d "spider_parameters=[{\"url\": \"https://www.zillow.com/homedetails/2506-Gordon-Cir-South-Bend-IN-46635/77050198_zpid/?t=for_sale\"}]" ^
  -d "spider_errors=true" ^
  -d "file_name={{TasksID}}"
```

</details>

如果您需要进一步的帮助，请通过电子邮件联系 <support@thordata.com>。


---

# 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:

```
GET https://doc.thordata.com/doc/zh-hk/web-scraper-api/zhua-qu-can-shu-shuo-ming/zillow-zhua-qu-can-shu.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
