# Zillow Owner Agent Scraper (`burbn/zillow-owner-agent-scraper`) Actor

Extract owner and agent contact information from Zillow property listings. Get agent name, phone number, email, license number, broker details, MLS information, listing status, and rental contact data. Perfect for real estate lead generation, agent research, and property listing analysis.

- **URL**: https://apify.com/burbn/zillow-owner-agent-scraper.md
- **Developed by:** [Kevin](https://apify.com/burbn) (community)
- **Categories:** Lead generation, Real estate, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.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

## 🏠 Zillow Owner & Agent Scraper

Extract owner and agent contact information from Zillow property listings. This powerful Apify actor retrieves comprehensive agent, broker, and MLS data for any Zillow property.

### 🎯 What This Actor Does

This actor allows you to:
- **Get agent contact info** - Name, phone number, email, and license number
- **Extract broker details** - Broker name, phone, and office information
- **Access MLS data** - MLS ID, name, listing status, and disclaimers
- **Retrieve rental contacts** - Display name, business, phone, ratings, and reviews
- **Identify listing type** - Check if listed by owner or agent

### 🚀 How to Use

#### Step 1: Get Property URLs or ZPIDs

You can use either:
1. **Property URLs** - Copy the full URL from any Zillow property page
2. **ZPIDs** - Use the Zillow Property ID (found in the URL, e.g., `245070471_zpid`)

#### Step 2: Configure the Actor

| Input | Description | Default |
|-------|-------------|---------|
| `propertyUrls` | Array of Zillow property URLs | [] |
| `propertyZpids` | Array of Zillow Property IDs (ZPID) | [] |
| `delayBetweenRequests` | Delay in milliseconds between requests | 1000 |

#### Step 3: Run and Get Results

Run the actor and download your data in JSON, CSV, or Excel format.

### 📊 Output Data Structure

Each property result contains:

#### 🏠 Property Info
| Field | Description |
|-------|-------------|
| `zpid` | Zillow Property ID |
| `source` | Data source identifier |
| `isListedByOwner` | Whether listed by owner (FSBO) |

#### 👤 Agent Information
| Field | Description |
|-------|-------------|
| `agentName` | Primary listing agent name |
| `agentEmail` | Agent email address |
| `agentPhoneNumber` | Agent phone number |
| `agentLicenseNumber` | Agent license number |
| `listAgentFullName` | Full name of listing agent |
| `listAgentLicenseNumber` | Listing agent state license |

#### 👥 Co-Agent Information
| Field | Description |
|-------|-------------|
| `coAgentName` | Co-listing agent name |
| `coAgentLicenseNumber` | Co-agent license number |
| `coAgentNumber` | Co-agent phone number |

#### 🤝 Buyer Agent Information
| Field | Description |
|-------|-------------|
| `buyerAgentName` | Buyer's agent name |
| `buyerAgentMemberStateLicense` | Buyer agent license |
| `buyerBrokerageName` | Buyer's brokerage name |

#### 🏢 Broker & Office
| Field | Description |
|-------|-------------|
| `brokerName` | Broker/brokerage name |
| `brokerPhoneNumber` | Broker phone number |
| `officeName` | Listing office name |
| `listingOffices` | Array of all listing offices |
| `listingAgents` | Array of all listing agents |

#### 📋 MLS Information
| Field | Description |
|-------|-------------|
| `mlsId` | MLS listing ID |
| `mlsName` | MLS name (e.g., StreetEasy) |
| `mlsDisclaimer` | MLS disclaimer text |
| `trueStatus` | Current listing status |
| `attributionTitle` | Attribution title |
| `listingAgreement` | Listing agreement type |
| `providerLogo` | Provider logo URL |

#### ⏰ Timestamps
| Field | Description |
|-------|-------------|
| `lastChecked` | Last data check timestamp |
| `lastUpdated` | Last data update timestamp |

#### 🏘️ Rental Contact
| Field | Description |
|-------|-------------|
| `rentalDisplayName` | Rental contact display name |
| `rentalBusinessName` | Business name |
| `rentalPhoneNumber` | Contact phone |
| `rentalAgentBadgeType` | Agent badge type |
| `rentalPhotoUrl` | Contact photo URL |
| `rentalReviewsCount` | Number of reviews |
| `rentalReviewsUrl` | Reviews page URL |
| `rentalRatingAverage` | Average rating |

### 📋 Example Input

#### Using Property URLs
```json
{
  "propertyUrls": [
    "https://www.zillow.com/homedetails/1770-E-14th-St-APT-5G-Brooklyn-NY-11229/245070471_zpid/"
  ],
  "delayBetweenRequests": 1000
}
````

#### Using ZPIDs

```json
{
  "propertyZpids": [
    "245070471",
    "123456789"
  ],
  "delayBetweenRequests": 1000
}
```

#### Using Both

```json
{
  "propertyUrls": [
    "https://www.zillow.com/homedetails/1770-E-14th-St-APT-5G-Brooklyn-NY-11229/245070471_zpid/"
  ],
  "propertyZpids": [
    "123456789"
  ],
  "delayBetweenRequests": 1000
}
```

### 📋 Example Output

```json
{
  "inputIdentifier": "https://www.zillow.com/homedetails/1770-E-14th-St-APT-5G-Brooklyn-NY-11229/245070471_zpid/",
  "zpid": "245070471",
  "source": "9vrc_pr_zpd",
  "isListedByOwner": false,
  "agentName": "Ayzik Nasimov",
  "agentEmail": null,
  "agentPhoneNumber": "718-975-0555",
  "agentLicenseNumber": null,
  "listAgentFullName": "Ayzik Nasimov",
  "listAgentLicenseNumber": "10301213689",
  "coAgentName": null,
  "coAgentLicenseNumber": null,
  "coAgentNumber": null,
  "buyerAgentName": null,
  "buyerAgentMemberStateLicense": null,
  "buyerBrokerageName": null,
  "brokerName": "Ilite Realty Inc",
  "brokerPhoneNumber": "718-975-0555",
  "officeName": "Ilite Realty Inc",
  "listingOffices": [
    {
      "associatedOfficeType": "listOffice",
      "officeName": "Ilite Realty Inc"
    }
  ],
  "listingAgents": [
    {
      "associatedAgentType": "listAgent",
      "memberFullName": "Ayzik Nasimov",
      "memberStateLicense": "10301213689"
    }
  ],
  "mlsId": "S1804233",
  "mlsName": "StreetEasy",
  "mlsDisclaimer": "",
  "trueStatus": "Active",
  "attributionTitle": "Listing by:",
  "listingAgreement": null,
  "providerLogo": null,
  "lastChecked": "2025-12-28 05:31:01",
  "lastUpdated": "2025-12-27 07:47:40",
  "rentalDisplayName": null,
  "rentalBusinessName": null,
  "rentalPhoneNumber": null,
  "rentalAgentBadgeType": null,
  "rentalPhotoUrl": "",
  "rentalReviewsCount": null,
  "rentalReviewsUrl": null,
  "rentalRatingAverage": null,
  "rentalIsBrokerLocalCompliance": null,
  "message": "200: Success"
}
```

### 🎨 Dataset Views

The actor provides 5 organized table views:

| View | Description |
|------|-------------|
| **Overview** | Quick view with agent, broker, MLS, and status |
| **Agent Details** | Complete agent info with licenses and co-agents |
| **Broker & Office** | Broker and office details with buyer agent info |
| **MLS Information** | MLS data, status, and timestamps |
| **Rental Contact** | Rental-specific contact information |

### 🔧 Tips for Best Results

1. **Use valid URLs** - Ensure property URLs are complete and valid Zillow property pages
2. **Check ZPID format** - ZPIDs are numeric IDs found in property URLs
3. **Adjust delay** - Increase delay if you encounter rate limiting
4. **Bulk processing** - Process multiple properties in a single run for efficiency

### 📌 Use Cases

- **Real Estate Lead Generation** - Build agent contact lists for marketing
- **Agent Research** - Verify agent licenses and broker affiliations
- **Market Analysis** - Track which brokers are active in specific areas
- **Listing Verification** - Confirm listing status and agent information
- **FSBO Identification** - Find properties listed by owners

### 🔗 Related Actors

- [Zillow Search by URL](https://apify.com/burbn/zillow-search-by-url) - Search properties by Zillow search URL
- [Zillow Property Scraper](https://apify.com/burbn/zillow-home-scraper-by-url) - Get detailed property data
- [Zillow Address Scraper](https://apify.com/burbn/zillow-address-scraper) - Search properties by address

### 📞 Support

For questions, feedback, or issues, please contact us through Apify or open an issue.

***

**Happy scraping! 🏠✨**

# Actor input Schema

## `propertyUrls` (type: `array`):

Enter Zillow property page URLs. Example: https://www.zillow.com/homedetails/1770-E-14th-St-APT-5G-Brooklyn-NY-11229/245070471\_zpid/

## Actor input object example

```json
{
  "propertyUrls": [
    "https://www.zillow.com/homedetails/1770-E-14th-St-APT-5G-Brooklyn-NY-11229/245070471_zpid/"
  ]
}
```

# Actor output Schema

## `overview` (type: `string`):

View all properties with agent name, phone, email, broker, MLS, and listing status.

## `agentDetails` (type: `string`):

View detailed agent information including license numbers, co-agents, and contact details.

## `brokerInfo` (type: `string`):

View broker and office details including buyer agent information and brokerage data.

## `mlsInfo` (type: `string`):

View MLS details including MLS ID, name, listing status, and timestamps.

## `rentalContact` (type: `string`):

View rental contact information including display name, phone, ratings, and reviews.

# 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 = {
    "propertyUrls": [
        "https://www.zillow.com/homedetails/1770-E-14th-St-APT-5G-Brooklyn-NY-11229/245070471_zpid/"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("burbn/zillow-owner-agent-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 = { "propertyUrls": ["https://www.zillow.com/homedetails/1770-E-14th-St-APT-5G-Brooklyn-NY-11229/245070471_zpid/"] }

# Run the Actor and wait for it to finish
run = client.actor("burbn/zillow-owner-agent-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 '{
  "propertyUrls": [
    "https://www.zillow.com/homedetails/1770-E-14th-St-APT-5G-Brooklyn-NY-11229/245070471_zpid/"
  ]
}' |
apify call burbn/zillow-owner-agent-scraper --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Zillow Owner Agent Scraper",
        "description": "Extract owner and agent contact information from Zillow property listings. Get agent name, phone number, email, license number, broker details, MLS information, listing status, and rental contact data. Perfect for real estate lead generation, agent research, and property listing analysis.",
        "version": "1.0",
        "x-build-id": "wRV7DhrSTdbv1iul6"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/burbn~zillow-owner-agent-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-burbn-zillow-owner-agent-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/burbn~zillow-owner-agent-scraper/runs": {
            "post": {
                "operationId": "runs-sync-burbn-zillow-owner-agent-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/burbn~zillow-owner-agent-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-burbn-zillow-owner-agent-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": {
                    "propertyUrls": {
                        "title": "🔗 Property URLs",
                        "minItems": 1,
                        "maxItems": 100,
                        "type": "array",
                        "description": "Enter Zillow property page URLs. Example: https://www.zillow.com/homedetails/1770-E-14th-St-APT-5G-Brooklyn-NY-11229/245070471_zpid/",
                        "items": {
                            "type": "string"
                        },
                        "default": [
                            "https://www.zillow.com/homedetails/1770-E-14th-St-APT-5G-Brooklyn-NY-11229/245070471_zpid/"
                        ]
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
