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