# Zillow Scraping Parameters

Web Scraper API Zillow Scraping Parameters\
Use Thordata's Web Scraper API to configure Zillow scraping parameters, including Zillow URLs, location keywords, listing categories, homepage type, days on Zillow, maximum quantity, and more.

Unique Identifier: 

<details>

<summary><code>token</code> <strong>，Access Token (Required)</strong></summary>

This parameter is used to verify the legitimacy of the scraping request via an API access token.

**Request Example:**

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

**I 、Product - Scraping Property Details:**

1. Zillow - Scraping property details via URL

<details>

<summary><code>spider_id</code> ，<strong>Associated Scraping Tool (Required)</strong></summary>

This parameter defines which scraping tool to use.&#x20;

**Request Example:**

`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 (Required)</strong></summary>

This parameter specifies the Zillow property details link to be crawled.

**Request Example:**

`"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 - scrape property details by input filter

<details>

<summary><code>spider_id</code> ，<strong>Associated Scraping Tool (Required)</strong></summary>

This parameter defines which scraping tool to use.&#x20;

**Request Example:**

```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>Location keywords (Required)</strong></summary>

This parameter is used to specify the search address information for the Zillow search page, which can be a postal code, a specific city, or an address.

**Request Example:**

`"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>List Category (Optional)</strong></summary>

This parameter specifies the property category to search for on Zillow, including sold, rented, and for sale.\
Parameter value: `Sold` ，`For Rent` ，`For Sale`

**Request Example:**

`"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>Homepage Type (Optional)</strong></summary>

This parameter specifies the type of property page that Zillow searches for, including single-family homes, townhouses, multi-family homes, condos/co-ops, lots/land, apartments, and manufactured homes.\
Parameter value：
`Houses`
&#x20;`Townhomes`
&#x20;`Multi-family`
&#x20;`Condos/Co-ops`
&#x20;`Lots/Land` `Apartments`
&#x20;`Manufactured`

**Request Example:**

`"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>Days on Zillow (optional)</strong></summary>

This parameter specifies how long the listings on Zillow have been available for crawling.\
Parameter value：`Any` `1 day` `7 days` `14 days` `30 days` `90 days` `6 months` `12 months` `24 months` `36 months`

**Request Example:**

`"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>Maximum quantity (Required)</strong></summary>

This parameter is used to specify the maximum number of Zillow real estate information to be crawled.

**Request Example:**

`"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 - Get property details by entering the listing URL

<details>

<summary><code>spider_id</code> ，<strong>Associated Scraping Tool (Required)</strong></summary>

This parameter defines which scraping tool to use.&#x20;

**Request Example:**

`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>Listing Site (Required)</strong></summary>

This parameter specifies the Zillow real estate listing URL to be crawled.

**Request Example:**

`"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>Maximum quantity (Required)</strong></summary>

This parameter is used to specify the maximum number of Zillow real estate information to be crawled.

**Request Example:**

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

**II. Product - Capturing Property Price History:**

1. Zillow - Capturing Price History via URL

<details>

<summary><code>spider_id</code> ，<strong>Associated Scraping Tool (Required)</strong></summary>

This parameter defines which scraping tool to use.&#x20;

**Request Example:**

`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 (Required)</strong></summary>

This parameter specifies the Zillow property details link to be crawled.

**Request Example:**

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

If you need further assistance, please contact us via email at <support@thordata.com>.