# Zillow 抓取参数

Web Scraper API Zillow 抓取参数

使用 Thordata 的 Web Scraper API 配置 Zillow 抓取参数，包括Zillow URL、地点关键词、列表类别、主页类型、在Zillow上的日子、最多数量等参数。

唯一标识：&#x20;

<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抓取房产详情信息&#x20;

<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-通过输入过滤器抓取房产详细信息&#x20;

<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 房产列表链接。&#x20;

**示例请求：**

`"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>

**二、产品-抓取房产价格历史信息：**

1. Zillow-通过URL抓取价格历史信息&#x20;

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