# Realtor Agents by ZIP Code (Preprocessed Data) (`scraped/realtor-agents-by-zip-code-preprocessed-data`)

This actor allows you to retrieve real estate agent listings from a preprocessed, large-scale CSV feed sourced from Realtor.com. By specifying a U.S. ZIP code, the actor filters and returns matching agents who serve that area.

- **URL**: https://beta-securitybyobscurity.apify.com/scraped/realtor-agents-by-zip-code-preprocessed-data.md
- **Developed by:** [scraped](https://beta-securitybyobscurity.apify.com/scraped) (community)
- **Categories:** Automation, Lead generation, Social media
- **Stats:** 56 total users, 16 monthly users, 98.7% runs succeeded, 3 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

$10.00 / 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

## Realtor.com Agent Scraper

This scraper collects pre-processed data about real estate agents from [Realtor.com](https://www.realtor.com/), specifically for agents who service the zip codes you specify. It scrapes relevant data such as the agent's name, contact information, listing statistics, and the zip codes they service.

### Instructions

Enter `zipcode` and run, it's that simple!

### Sample Output

Here's an example of the data the scraper will output (sensitive data is removed for privacy):

```json

{
Agent Photo: "http://p.rdcpix.com/v02/gbf681200-c0md-r1.jpg",
Areas serviced: "Boston, Dorchester, Los Angeles, Beverly Hills, Pacific Palisades, Santa Monica, Wilmington",
Email: "Mxxxxxxx@xx.com",
First Year in Business: "2001.0",
Full Name: "Michael A.J. Ferretti, Broker",
Languages: "",
Listing Count: "0",
Listing Last Date: "",
Listing Price Max: "0",
Listing Price Min: "0",
Mobile Phones: "(310) 896-xxxx",
Office Address: "1 Washington Mall #1068, Boston, MA, 02108, US",
Office Email: "",
Office Name: "Dupont Street Realty Advisors",
Office Phone: "",
Office Website: "www.DuPontSt.com",
Review Count: "0",
Role: "agent",
Sold Count: "1",
Sold Last Date: "2023-08-24",
Sold Price Max: "109140",
Sold Price Min: "109140",
Title: "Broker",
Web URL: "https://www.realtor.com/realestateagents/Michael-A.J.-Ferretti_Boston_MA_1206463_077084055",
Zip codes serviced: "02110, 02115, 02116, 02117, 02118, 02125, 02215, 90049, 90210, 90211, 90213, 90272, 90401, 90402, 90403, 90404, 90405, 19805, 19809"
},
```

### Data dictionary

**\[Agent name]** The full name of the agent.
**\[Website]** A link to the agent's personal or office website.
**\[Email]** The agent's email address. (Ensure compliance with all relevant laws and regulations regarding email communication. The scraper collects this data for informational purposes only, and we are not responsible for misuse, spamming, or unsolicited contact.)
**\[Listing count]** The number of listings the agent currently has.
**\[Sold count]** The number of properties the agent has sold.
**\[Office Phone]** If available, the office phone number. (May be null.)
**\[Mobile Phones]** The agent's mobile phone number.
**\[Areas serviced]** The areas the agent services.
**\[Zip codes serviced]** A list of zip codes where the agent provides services.
**\[Office / Company name]** The name of the agent's office or company. (May be empty.)
**\[Company website]** The website agent's office or company. (May be empty.)
**\[Review count]** The number of reviews the agent has on Realtor.com
**\[Agent Photo]** Photo of agent (if available)

\##Trial users

Results for trial users are limited to 10 records. Please consider supporting us by renting out this actor.

### Legal Notice

This scraper collects publicly available data from Realtor.com. This data was pre-processed and may not reflect the latest data available on Realtor.com
It is your responsibility to ensure that you comply with all relevant laws and regulations when contacting agents, especially regarding unsolicited communication and privacy policies.
The scraper collects email addresses for informational purposes only. We are not responsible for any misuse or violation of anti-spam laws. Always respect the agent's privacy and adhere to applicable communication regulations.

### Full List Available For Purchase

Email: 434399 records (99.40%) out of 437020
Mobile Phones: 363704 records (83.22%) out of 437020
Office Phone: 165788 records (37.94%) out of 437020
Office Email: 386565 records (88.45%) out of 437020

### Support

Please email scraperhelp@gmail.com if you need any additional support.

# Actor input Schema

## `zip_codes` (type: `array`):

List of zip codes you want to get data for.

## Actor input object example

```json
{
  "zip_codes": [
    "97229",
    "90210"
  ]
}
```

# 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 = {
    "zip_codes": [
        "97229",
        "90210"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("scraped/realtor-agents-by-zip-code-preprocessed-data").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 = { "zip_codes": [
        "97229",
        "90210",
    ] }

# Run the Actor and wait for it to finish
run = client.actor("scraped/realtor-agents-by-zip-code-preprocessed-data").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 '{
  "zip_codes": [
    "97229",
    "90210"
  ]
}' |
apify call scraped/realtor-agents-by-zip-code-preprocessed-data --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=scraped/realtor-agents-by-zip-code-preprocessed-data",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Realtor Agents by ZIP Code (Preprocessed Data)",
        "description": "This actor allows you to retrieve real estate agent listings from a preprocessed, large-scale CSV feed sourced from Realtor.com. By specifying a U.S. ZIP code, the actor filters and returns matching agents who serve that area.",
        "version": "0.0",
        "x-build-id": "KoppL0Wlce8DOf69h"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/scraped~realtor-agents-by-zip-code-preprocessed-data/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-scraped-realtor-agents-by-zip-code-preprocessed-data",
                "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/scraped~realtor-agents-by-zip-code-preprocessed-data/runs": {
            "post": {
                "operationId": "runs-sync-scraped-realtor-agents-by-zip-code-preprocessed-data",
                "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/scraped~realtor-agents-by-zip-code-preprocessed-data/run-sync": {
            "post": {
                "operationId": "run-sync-scraped-realtor-agents-by-zip-code-preprocessed-data",
                "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": [
                    "zip_codes"
                ],
                "properties": {
                    "zip_codes": {
                        "title": "Zipcode(s)",
                        "type": "array",
                        "description": "List of zip codes you want to get data for.",
                        "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
