# Affordable Zillow Details Scraper (Pay-Per-Result) (`kawsar/affordable-zillow-details-scraper`) Actor
Zillow property details scraper that extracts pricing, features, tax records, and neighborhood data from any listing using URLs, ZPIDs, or addresses, so real estate teams can build datasets without manual lookups.
- **URL**: https://apify.com/kawsar/affordable-zillow-details-scraper.md
- **Developed by:** [Kawsar](https://apify.com/kawsar) (community)
- **Categories:** Real estate, Automation, Developer tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet
## Pricing
from $1.00 / 1,000 results
This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.
Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event
## What's an Apify Actor?
Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".
## How to integrate an Actor?
If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.
In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):
```bash
npm install apify-client
```
In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):
```bash
pip install apify-client
```
In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):
````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash
In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).
If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).
For usage examples, see the [API](#api) section below.
For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).
# README
## Affordable Zillow Details Scraper: Get Property Data by URL, ZPID, or Address
This Zillow scraper pulls property details in real time from Zillow listings. Hand it a property URL, a Zillow Property ID (ZPID), or a plain street address, and it gives back structured data you can feed into spreadsheets, databases, or analysis tools. You only pay for results that actually come back, so there's no charge for failed lookups.
### Use cases
- **Real estate market research**: pull listing prices, Zestimates, and days-on-market for dozens of properties in one run and compare them side by side
- **Investment property analysis**: grab tax assessments, price history, and rental estimates to evaluate potential returns without manually visiting each listing
- **Lead generation for agents**: look up property details in bulk to build prospect lists with accurate pricing and owner info
- **Portfolio monitoring**: re-run the actor on a schedule to track price changes, status updates, and new Zestimates for properties you're watching
- **Academic and data journalism projects**: collect structured Zillow data across ZIP codes or neighborhoods for housing affordability studies
### What data does this actor extract?
The actor returns a JSON object for each property. Fields vary depending on what Zillow has on file, but a typical response includes:
```json
{
"zpid": "19435371",
"propertyUrl": "https://www.zillow.com/homedetails/10791-Gooseberry-Ct-Truckee-CA-96161/19435371_zpid/",
"streetAddress": "10791 Gooseberry Ct",
"city": "Truckee",
"state": "CA",
"zipcode": "96161",
"price": 1250000,
"zestimate": 1230000,
"rentZestimate": 5200,
"bedrooms": 4,
"bathrooms": 3.5,
"livingArea": 2800,
"lotSize": 10454,
"yearBuilt": 2005,
"homeType": "SINGLE_FAMILY",
"homeStatus": "FOR_SALE",
"daysOnZillow": 14,
"taxAssessedValue": 980000,
"annualPropertyTax": 12500,
"latitude": 39.3277,
"longitude": -120.2137,
"photoUrls": ["https://..."],
"listingAgent": {"name": "Jane Smith", "phone": "530-555-0100"},
"priceHistory": [{"date": "2023-06-15", "price": 1200000, "event": "Listed"}],
"taxHistory": [{"year": 2023, "taxPaid": 12500, "assessedValue": 980000}],
"schools": [{"name": "Truckee Elementary", "rating": 7, "distance": 1.2}],
"fetchedAt": "2025-04-13T07:30:00Z",
"inputSource": "zpid"
}
````
### Input
| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `property_url` | array | — | Full Zillow listing URLs. The actor parses each URL to extract the ZPID automatically. |
| `zpid` | array | — | Numeric Zillow Property IDs. Fastest lookup method since it skips URL parsing. |
| `address` | array | — | US street addresses in "Street, City, State ZIP" format. The actor searches Zillow for each one. |
| `maxItems` | integer | 100 | Cap on total properties processed per run. Set to 0 for no limit. |
| `timeoutSecs` | integer | 300 | Max run time in seconds. Results collected before timeout are still saved. |
| `requestTimeoutSecs` | integer | 30 | Per-request timeout. Increase if individual lookups time out frequently. |
#### Example input
```json
{
"property_url": [
"https://www.zillow.com/homedetails/21921-Calhoun-Dr-California-City-CA-93505/81863076_zpid/",
"https://www.zillow.com/homedetails/20649-83rd-St-California-City-CA-93505/18961308_zpid/"
],
"zpid": ["19435371", "30588492"],
"address": ["11013 Rome Beauty Dr, California City", "17338 Kiowa River Ln, Houston, TX 77095"],
"maxItems": 50
}
```
### Output
The actor stores each property as a separate item in the dataset. You can export results as JSON, CSV, XML, or Excel.
| Field | Type | Description |
|-------|------|-------------|
| `zpid` | string | Zillow Property ID |
| `propertyUrl` | string | Direct link to the Zillow listing |
| `streetAddress` | string | Street address of the property |
| `city` | string | City name |
| `state` | string | Two-letter state code |
| `zipcode` | string | 5-digit ZIP |
| `price` | number | Current listing price or last sale price in USD |
| `zestimate` | number | Zillow's automated valuation in USD |
| `rentZestimate` | number | Estimated monthly rent in USD |
| `bedrooms` | integer | Bedroom count |
| `bathrooms` | number | Bathroom count (decimals for half baths) |
| `livingArea` | number | Interior square footage |
| `lotSize` | number | Lot square footage |
| `yearBuilt` | integer | Year the home was built |
| `homeType` | string | SINGLE\_FAMILY, CONDO, TOWNHOUSE, etc. |
| `homeStatus` | string | FOR\_SALE, SOLD, PENDING, etc. |
| `daysOnZillow` | integer | Days since the current listing went live |
| `taxAssessedValue` | number | Latest tax assessment in USD |
| `annualPropertyTax` | number | Annual property tax in USD |
| `latitude` | number | Latitude coordinate |
| `longitude` | number | Longitude coordinate |
| `photoUrls` | array | URLs to listing photos |
| `listingAgent` | object | Agent name, phone, brokerage |
| `priceHistory` | array | Past price changes and sale records |
| `taxHistory` | array | Tax assessment history |
| `schools` | array | Nearby schools with ratings and distance |
| `fetchedAt` | string | ISO 8601 timestamp of when data was pulled |
| `input_query` | string | The original input you provided (URL, ZPID, or address) — always present even on errors |
| `inputSource` | string | Which input type triggered this lookup |
| `errorMessage` | string | Error details if the lookup failed |
### How it works
1. You provide Zillow property URLs, ZPIDs, or street addresses (any combination works).
2. The actor merges all inputs into one processing queue and deduplicates where possible.
3. Each property gets looked up individually through a real-time API call.
4. Successful results are saved to the dataset immediately. Failed lookups get an error record so you know what went wrong.
5. The run stops when all properties are processed or when the timeout/max-items limit is hit, whichever comes first.
Proxy rotation is handled internally. Each property lookup uses a fresh proxy URL, which reduces the chance of rate limiting or IP blocks.
### FAQ
**How much does each property lookup cost?**
You pay per successful result only. Failed lookups (404s, timeouts, invalid addresses) do not count toward your usage. Check the actor's pricing page on Apify for current rates.
**Can I look up off-market or sold properties?**
Yes. The actor returns data for any property that has a Zillow listing page, including sold, pending, and off-market properties. The `homeStatus` field tells you the current state.
**What happens if I submit a bad URL or address?**
The actor logs an error for that item and moves on to the next one. You will find an error record in the output dataset with the `errorMessage` field explaining what went wrong.
**How fast is it?**
Each property lookup takes 2 to 5 seconds on average. A batch of 100 properties typically finishes in under 10 minutes.
**Can I run this on a schedule?**
Absolutely. Set up a schedule on Apify to run the actor daily, weekly, or at whatever interval you need. Each run picks up the latest data from Zillow.
### Integrations
Connect Affordable Zillow Details Scraper with other apps and services using [Apify integrations](https://apify.com/integrations). You can integrate with Make, Zapier, Slack, Airbyte, GitHub, Google Sheets, Google Drive, and many more. You can also use [webhooks](https://docs.apify.com/integrations/webhooks) to trigger actions whenever results are available.
This Zillow property data scraper works well as part of a larger pipeline: feed addresses from a CRM, run the actor, and push results to Google Sheets or a database for your team to review.
# Actor input Schema
## `property_url` (type: `array`):
Enter full Zillow property page URLs. Each URL gets parsed automatically to extract the Zillow Property ID (ZPID). Supports standard listing pages, For Sale By Owner pages, and pre-foreclosure URLs. You can paste URLs directly from your browser address bar. Example format: https://www.zillow.com/homedetails/\[address]/\[zpid]\_zpid/
## `zpid` (type: `array`):
Enter Zillow Property IDs as numbers. Every property on Zillow has a unique numeric ZPID. You can find it in the URL of any Zillow listing page (the number before \_zpid). This is the fastest lookup method since it skips URL parsing and address resolution. Supports bulk input for processing hundreds of properties at once.
## `address` (type: `array`):
Enter property addresses in standard US format: Street Address, City, State ZIP. The actor searches Zillow for each address and returns matching property details. Works with most US residential properties including single-family homes, condos, townhouses, and multi-family dwellings. Partial addresses may return multiple matches. For best results, include the full street address with ZIP code.
## `maxItems` (type: `integer`):
Limit the total number of properties the actor will process in a single run. This helps you control costs and avoid accidentally processing a larger batch than intended. Set to 0 or leave empty for no limit (processes all provided inputs).
## `timeoutSecs` (type: `integer`):
Maximum total time the actor will run before stopping. If the timeout is reached, results collected so far are still saved to the dataset. Increase this for large batches with hundreds of properties.
## `requestTimeoutSecs` (type: `integer`):
Maximum time allowed for each individual property lookup. If a single request takes longer than this, the actor skips that property and moves to the next one. Increase if you experience frequent timeouts on slower connections.
## Actor input object example
```json
{
"property_url": [
"https://www.zillow.com/homedetails/21921-Calhoun-Dr-California-City-CA-93505/81863076_zpid/"
],
"zpid": [
"19435371"
],
"address": [
"11013 Rome Beauty Dr, California City"
],
"maxItems": 100,
"timeoutSecs": 300,
"requestTimeoutSecs": 30
}
```
# 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 '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {
"property_url": [
"https://www.zillow.com/homedetails/21921-Calhoun-Dr-California-City-CA-93505/81863076_zpid/",
"https://www.zillow.com/homedetails/20649-83rd-St-California-City-CA-93505/18961308_zpid/"
],
"zpid": [
"19435371",
"30588492"
],
"address": [
"11013 Rome Beauty Dr, California City",
"17338 Kiowa River Ln, Houston, TX 77095"
],
"maxItems": 100,
"timeoutSecs": 300,
"requestTimeoutSecs": 30
};
// Run the Actor and wait for it to finish
const run = await client.actor("kawsar/affordable-zillow-details-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 '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = {
"property_url": [
"https://www.zillow.com/homedetails/21921-Calhoun-Dr-California-City-CA-93505/81863076_zpid/",
"https://www.zillow.com/homedetails/20649-83rd-St-California-City-CA-93505/18961308_zpid/",
],
"zpid": [
"19435371",
"30588492",
],
"address": [
"11013 Rome Beauty Dr, California City",
"17338 Kiowa River Ln, Houston, TX 77095",
],
"maxItems": 100,
"timeoutSecs": 300,
"requestTimeoutSecs": 30,
}
# Run the Actor and wait for it to finish
run = client.actor("kawsar/affordable-zillow-details-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 '{
"property_url": [
"https://www.zillow.com/homedetails/21921-Calhoun-Dr-California-City-CA-93505/81863076_zpid/",
"https://www.zillow.com/homedetails/20649-83rd-St-California-City-CA-93505/18961308_zpid/"
],
"zpid": [
"19435371",
"30588492"
],
"address": [
"11013 Rome Beauty Dr, California City",
"17338 Kiowa River Ln, Houston, TX 77095"
],
"maxItems": 100,
"timeoutSecs": 300,
"requestTimeoutSecs": 30
}' |
apify call kawsar/affordable-zillow-details-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=kawsar/affordable-zillow-details-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "Affordable Zillow Details Scraper (Pay-Per-Result)",
"description": "Zillow property details scraper that extracts pricing, features, tax records, and neighborhood data from any listing using URLs, ZPIDs, or addresses, so real estate teams can build datasets without manual lookups.",
"version": "0.0",
"x-build-id": "s4JRCe9a5mqP3BLj6"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/kawsar~affordable-zillow-details-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-kawsar-affordable-zillow-details-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/kawsar~affordable-zillow-details-scraper/runs": {
"post": {
"operationId": "runs-sync-kawsar-affordable-zillow-details-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/kawsar~affordable-zillow-details-scraper/run-sync": {
"post": {
"operationId": "run-sync-kawsar-affordable-zillow-details-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",
"properties": {
"property_url": {
"title": "Property URLs",
"type": "array",
"description": "Enter full Zillow property page URLs. Each URL gets parsed automatically to extract the Zillow Property ID (ZPID). Supports standard listing pages, For Sale By Owner pages, and pre-foreclosure URLs. You can paste URLs directly from your browser address bar. Example format: https://www.zillow.com/homedetails/[address]/[zpid]_zpid/",
"items": {
"type": "string"
}
},
"zpid": {
"title": "Zillow Property IDs (ZPID)",
"type": "array",
"description": "Enter Zillow Property IDs as numbers. Every property on Zillow has a unique numeric ZPID. You can find it in the URL of any Zillow listing page (the number before _zpid). This is the fastest lookup method since it skips URL parsing and address resolution. Supports bulk input for processing hundreds of properties at once.",
"items": {
"type": "string"
}
},
"address": {
"title": "Property Addresses",
"type": "array",
"description": "Enter property addresses in standard US format: Street Address, City, State ZIP. The actor searches Zillow for each address and returns matching property details. Works with most US residential properties including single-family homes, condos, townhouses, and multi-family dwellings. Partial addresses may return multiple matches. For best results, include the full street address with ZIP code.",
"items": {
"type": "string"
}
},
"maxItems": {
"title": "Maximum properties to process",
"minimum": 0,
"maximum": 1000,
"type": "integer",
"description": "Limit the total number of properties the actor will process in a single run. This helps you control costs and avoid accidentally processing a larger batch than intended. Set to 0 or leave empty for no limit (processes all provided inputs).",
"default": 100
},
"timeoutSecs": {
"title": "Overall timeout (seconds)",
"minimum": 30,
"maximum": 3600,
"type": "integer",
"description": "Maximum total time the actor will run before stopping. If the timeout is reached, results collected so far are still saved to the dataset. Increase this for large batches with hundreds of properties.",
"default": 300
},
"requestTimeoutSecs": {
"title": "Per-request timeout (seconds)",
"minimum": 10,
"maximum": 120,
"type": "integer",
"description": "Maximum time allowed for each individual property lookup. If a single request takes longer than this, the actor skips that property and moves to the next one. Increase if you experience frequent timeouts on slower connections.",
"default": 30
}
}
},
"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
}
}
}
}
}
}
}
}
}
}
```