# 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:&#x20;

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


---

# Agent Instructions: 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/scraping/web-scraper-api/parameter-description/zillow-scraping-parameters.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.
