# Zillow Location Scraper (`dataharvester/zillow-location-scraper`)

Easily extract real estate properties for sale, for rent, or recently sold while also retrieving contact information of property owners.

- **URL**: https://beta-securitybyobscurity.apify.com/dataharvester/zillow-location-scraper.md
- **Developed by:** [DataHarvester](https://beta-securitybyobscurity.apify.com/dataharvester) (community)
- **Categories:** Real estate
- **Stats:** 57 total users, 14 monthly users, 90.5% runs succeeded, 4 bookmarks
- **User rating**: No ratings yet

## Pricing

$1.85 / 1,000 results

This Actor is paid per result. You are not charged for the Apify platform usage, but only a fixed price for dataset items the Actor outputs.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-result

# README

![Example Image](https://upload.wikimedia.org/wikipedia/commons/thumb/e/eb/Zillow_logo.svg/1280px-Zillow_logo.svg.png)

## About This Actor

This actor is an advanced user-friendly tool designed to easily extract real estate properties for sale, for rent, or recently sold from Zillow. By entering a specific location—such as a ZIP code, state, or city—you can scrape detailed property listings that include contact information of property owners as well as price and many other fields. It guarantees the most accurate and up-to-date information for all relevant properties, saving you valuable time. Plus, you won't face API call limitations, allowing for unrestricted data collection ensuring you get the insights you need seamlessly.

### Why Use Zillow Location Scraper?

Zillow Location Scraper is perfect for anyone looking to connect with property managers, landlords, or investors—whether you’re a real estate agent, an investor seeking direct communication about opportunities, or a renter trying to reach landlords quickly. By gathering all properties in a specific location, this tool streamlines your search process and provides a comprehensive view of the market. Making it easy for anyone to access the vital details they need to enhance networking and to facilitate quicker decision-making in the real estate market.

### What Information Can Zillow Location Scraper Parse?

Zillow Location Scraper efficiently extracts key details from property listings, including the owners names and phone numbers, price, Zestimate, full address, number of bedrooms and bathrooms, total living area, and much more, as shown below.

## Basic Usage

***Example #1: Basic Usage***

```json
{
  "locations": [
    "90210",
    "Beverly Hills",
    "CA"
  ]
}
```

| Parameter  | Type   | Description                                                                |
|------------|--------|----------------------------------------------------------------------------|
| `locations`  | Array  | An array of locations. You can provide either a ZIP code (e.g., 90210), a state (e.g., CA), or a city (e.g., Beverly Hills). Multiple locations can be included. |

<br>

> **Note:** If you provide a single location, it should still be formatted as an array (e.g., `["90210"]`).
>
> <br>

## Sample Output

Here is the sample output of this actor:

```json
{
    "zpid": "20534468",
    "id": "20534468",
    "rawHomeStatusCd": "ForSale",
    "marketingStatusSimplifiedCd": "For Sale by Agent",
    "imgSrc": "https://photos.zillowstatic.com/fp/fbe5cd2fe4f540d29e0e13219a9c240d-p_e.jpg",
    "hasImage": true,
    "detailUrl": "https://www.zillow.com/homedetails/410-Trousdale-Pl-Beverly-Hills-CA-90210/20534468_zpid/",
    "statusType": "FOR_SALE",
    "statusText": "House for sale",
    "countryCurrency": "$",
    "price": "$68,000,000",
    "unformattedPrice": 68000000,
    "address": "410 Trousdale Pl, Beverly Hills, CA 90210",
    "addressStreet": "410 Trousdale Pl",
    "addressCity": "Beverly Hills",
    "addressState": "CA",
    "addressZipcode": "90210",
    "isUndisclosedAddress": false,
    "beds": 5,
    "baths": 10,
    "area": 18000,
    "latLong": {
      "latitude": 34.101074,
      "longitude": -118.3957
    },
    "isZillowOwned": false,
    "flexFieldText": "Wine cellar",
    "flexFieldType": "homeInsight",
    "hdpData": {
      "homeInfo": {
        "zpid": 20534468,
        "streetAddress": "410 Trousdale Pl",
        "zipcode": "90210",
        "city": "Beverly Hills",
        "state": "CA",
        "latitude": 34.101074,
        "longitude": -118.3957,
        "price": 68000000,
        "bathrooms": 10,
        "bedrooms": 5,
        "livingArea": 18000,
        "homeType": "SINGLE_FAMILY",
        "homeStatus": "FOR_SALE",
        "daysOnZillow": 111,
        "isFeatured": false,
        "shouldHighlight": false,
        "zestimate": 59852600,
        "rentZestimate": 266968,
        "listing_sub_type": {
          "is_FSBA": true
        },
        "isUnmappable": false,
        "isPreforeclosureAuction": false,
        "homeStatusForHDP": "FOR_SALE",
        "priceForHDP": 68000000,
        "timeOnZillow": 9672389000,
        "isNonOwnerOccupied": true,
        "isPremierBuilder": false,
        "isZillowOwned": false,
        "currency": "USD",
        "country": "USA",
        "taxAssessedValue": 40987547,
        "lotAreaValue": 1.9883,
        "lotAreaUnit": "acres",
        "isShowcaseListing": false
      }
    },
    "isSaved": false,
    "isUserClaimingOwner": false,
    "isUserConfirmedClaim": false,
    "pgapt": "ForSale",
    "sgapt": "For Sale (Broker)",
    "zestimate": 59852600,
    "shouldShowZestimateAsPrice": false,
    "has3DModel": false,
    "hasVideo": false,
    "isHomeRec": false,
    "hasAdditionalAttributions": true,
    "isFeaturedListing": false,
    "isShowcaseListing": false,
    "list": true,
    "relaxed": false,
    "info6String": "Kurt Rappaport DRE ## 01036061",
    "brokerName": "Westside Estate Agency Inc.",
    "BrokerPhone": "3109953214",
    "carouselPhotos": [
      {
        "url": "https://photos.zillowstatic.com/fp/fbe5cd2fe4f540d29e0e13219a9c240d-p_e.jpg"
      },
      {
        "url": "https://photos.zillowstatic.com/fp/4649f7c54564d267adb027fe5a69a422-p_e.jpg"
      },
      {
        "url": "https://photos.zillowstatic.com/fp/28dbf08903a91b9a39a4a3a58544aa88-p_e.jpg"
      },
      {
        "url": "https://photos.zillowstatic.com/fp/c3b57339a19f7a49d8e87fb4a0fc59c4-p_e.jpg"
      },
      {
        "url": "https://photos.zillowstatic.com/fp/a3e156bcca86763317c924a44a153c71-p_e.jpg"
      },
      {
        "url": "https://photos.zillowstatic.com/fp/a74cdf0857acdaf2c9edec7e1904b423-p_e.jpg"
      },
      {
        "url": "https://photos.zillowstatic.com/fp/86c49283842bb4488cec7c104fca3809-p_e.jpg"
      },
      {
        "url": "https://photos.zillowstatic.com/fp/96c027fbb3d27e7f2cec7af9fd25bb7d-p_e.jpg"
      },
      {
        "url": "https://photos.zillowstatic.com/fp/4859859c1978127f09c5ff800487e995-p_e.jpg"
      },
      {
        "url": "https://photos.zillowstatic.com/fp/2fe9b8eccc2d295e438964d605da95f8-p_e.jpg"
      },
      {
        "url": "https://photos.zillowstatic.com/fp/6f471f73b8f2d9f24895407da07e7000-p_e.jpg"
      },
      {
        "url": "https://photos.zillowstatic.com/fp/e63defb711869c0d74f5e0f31e70c855-p_e.jpg"
      },
      {
        "url": "https://photos.zillowstatic.com/fp/78e7ea07775f31c9665550051de607a5-p_e.jpg"
      },
      {
        "url": "https://photos.zillowstatic.com/fp/77783b6d3fd5c7c54578092900b376b7-p_e.jpg"
      },
      {
        "url": "https://photos.zillowstatic.com/fp/5ac3bac3b2b183f6109277ee1a6c7bc2-p_e.jpg"
      },
      {
        "url": "https://photos.zillowstatic.com/fp/8bb482f7645ac069d687550ca2ff880f-p_e.jpg"
      },
      {
        "url": "https://photos.zillowstatic.com/fp/55a6b9dc38e2bae5ef39a24d6f695088-p_e.jpg"
      },
      {
        "url": "https://photos.zillowstatic.com/fp/42049adc0a92753ec95df9c08b18eb54-p_e.jpg"
      },
      {
        "url": "https://photos.zillowstatic.com/fp/ad0141e9385ceae8e5e13b98ff53a5f6-p_e.jpg"
      },
      {
        "url": "https://photos.zillowstatic.com/fp/3fc688073198f5c6a5326e4d5bd18290-p_e.jpg"
      },
      {
        "url": "https://photos.zillowstatic.com/fp/8c3631cddaab274408fb5ececb1ca937-p_e.jpg"
      },
      {
        "url": "https://photos.zillowstatic.com/fp/c9b172bbedc24bd9ff144a304a9d6102-p_e.jpg"
      },
      {
        "url": "https://photos.zillowstatic.com/fp/433755ae0655df7c271fcbae4e8dc0a3-p_e.jpg"
      },
      {
        "url": "https://photos.zillowstatic.com/fp/0b6803a4511c44d1ef2535edea5e4c44-p_e.jpg"
      },
      {
        "url": "https://photos.zillowstatic.com/fp/8ff2406d9a092a5ca38444a0672499a8-p_e.jpg"
      },
      {
        "url": "https://photos.zillowstatic.com/fp/f381816e9c0055d37f0a5534ce32f86e-p_e.jpg"
      },
      {
        "url": "https://photos.zillowstatic.com/fp/a2f0e61960339598e842206603676ac4-p_e.jpg"
      },
      {
        "url": "https://photos.zillowstatic.com/fp/22a7e2856c0222a3b6d7585fbf42a7da-p_e.jpg"
      }
    ]
  }

```

## Support and Feedback

If you encounter any issues or have suggestions for improvements, feel free to reach out to us or create an issue on the Actor’s [Issues tab](https://console.apify.com/actors/J2VgOMYluGBZMaWmf/issues) in Apify Console.

## Similar Actors

[Zillow Phone Number Scraper](https://apify.com/dataharvester/zillow-phone-number-scraper)\
[Airbnb Review Scraper](https://apify.com/dataharvester/airbnb-review-scraper)\
[Airbnb Occupancy Scraper](https://apify.com/dataharvester/airbnb-occupancy-scraper)\
[Airbnb Price Scraper](https://apify.com/dataharvester/airbnb-price-scraper)

# Actor input Schema

## `locations` (type: `array`):

Array of locations you would like to search.

## Actor input object example

```json
{
  "locations": [
    "Beverly Hills",
    "90210",
    "CA"
  ]
}
```

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "locations": [
        "84525"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("dataharvester/zillow-location-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "locations": ["84525"] }

# Run the Actor and wait for it to finish
run = client.actor("dataharvester/zillow-location-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "locations": [
    "84525"
  ]
}' |
apify call dataharvester/zillow-location-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=dataharvester/zillow-location-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Zillow Location Scraper",
        "description": "Easily extract real estate properties for sale, for rent, or recently sold while also retrieving contact information of property owners.",
        "version": "1.0",
        "x-build-id": "cPaojfx0x0ZyuTGY4"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/dataharvester~zillow-location-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-dataharvester-zillow-location-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/dataharvester~zillow-location-scraper/runs": {
            "post": {
                "operationId": "runs-sync-dataharvester-zillow-location-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/dataharvester~zillow-location-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-dataharvester-zillow-location-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "required": [
                    "locations"
                ],
                "properties": {
                    "locations": {
                        "title": "Locations",
                        "type": "array",
                        "description": "Array of locations you would like to search.",
                        "items": {
                            "type": "string"
                        }
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
