# Realtor.com Agents Scraper - Profiles & Contact Data (`lentic_clockss/realtor-com-agents-scraper`) Actor
Scrape Realtor.com agents by US city or ZIP. Extract real estate agent phones, emails, ratings, sales stats, brokerage, languages, and served areas. A Realtor.com agent API alternative for Excel, CSV, or JSON.
- **URL**: https://apify.com/lentic\_clockss/realtor-com-agents-scraper.md
- **Developed by:** [kane liu](https://apify.com/lentic_clockss) (community)
- **Categories:** Real estate, Lead generation
- **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet
## Pricing
from $2.50 / 1,000 results
This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
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
## Realtor.com Agents Scraper — Profiles & Contact Data
**Scrape Realtor.com real estate agent profiles by US city or ZIP — then download structured agent contact data as Excel, CSV, or JSON.**
This Actor is a practical **Realtor.com agent API alternative** for lead generation, brokerage research, and market outreach. Enter a location such as `Austin, TX` or a ZIP like `78701`, and get agent rows with phones, office/broker, ratings, sales stats, languages, specializations, and served areas when present on the profile.
- Search **real estate agents** on [Realtor.com](https://www.realtor.com/realestateagents/)
- Resolve city or ZIP via Realtor.com geo suggest (`tx_austin` marketing area or postal code)
- Optionally **enrich** each agent with the AgentBranding profile (phones, MLS, office address)
- Filter by agent name, Realtor member flag, and price band
- Export to **Excel / CSV / JSON**, or connect Make, n8n, Zapier, Python, or MCP
- **Pay per event** — Actor start + each Dataset agent; no subscription
---
### What does the Realtor.com Agents Scraper do?
It turns a US city or ZIP agent search on Realtor.com into a clean Apify Dataset of agent profiles.
Under the hood, the Actor:
1. Resolves your location through Realtor.com geo suggest
2. Runs the `search_agents` GraphQL query for matching profiles
3. Optionally fetches AgentBranding enrichment for phones, office, MLS, and specializations
4. Writes normalized records you can download or push into automations
Apify **RESIDENTIAL** proxy is required on cloud runs (prefilled). Direct/datacenter traffic is often blocked.
---
### What data can you extract from Realtor.com agents?
| Data point | Included |
| --- | :---: |
| Agent name & profile URL | ✅ |
| Phone(s) | ✅ |
| Office / broker name | ✅ |
| Ratings & review counts | ✅ |
| For-sale / recently sold stats | ✅ |
| Languages & specializations | ✅ |
| Served areas | ✅ |
| License number / state | ✅ |
| MLS memberships | ✅ |
| Avatar, website, social links | ✅ |
| Bio / designations | ✅ |
Every Dataset row also includes `scrapedAt` and `source` = `realtor.com`. A `RUN_SUMMARY` record in the key-value store reports counts and warnings.
---
### What you can do with it
#### 1. Build a Realtor.com agent lead list for a city
Enter a city like `Austin, TX`, set max results, and export names, phones, offices, and profile URLs for outreach or CRM import.
#### 2. Scrape agents by ZIP code
Use a ZIP such as `78701` when you need a tighter local market than a full city marketing area.
#### 3. Enrich agent contact and brokerage details
Keep **Enrich profiles** enabled to pull AgentBranding fields (phones, office address, MLS, specializations) on top of search stubs.
#### 4. Filter by name, member status, or price band
Narrow results with `agentName`, `isRealtor`, and optional `minPrice` / `maxPrice` before saving rows.
#### 5. Feed agent data into automations
Schedule the Actor and send the Dataset to Sheets, Slack, CRM, Make, n8n, Zapier, or an AI agent via Apify MCP / API.
---
### How to scrape Realtor.com agents (no code required)
1. Click **Try for free**
2. Enter a location (`Austin, TX` or `78701`)
3. Optionally set agent name filter, max results, and enrich toggle
4. Keep **Apify RESIDENTIAL** proxy enabled
5. Click **Start** — open the **Dataset** tab when the run finishes
Start with `maxResults: 5–10` to verify the market, then scale up.
For developers: minimal input
```json
{
"location": "Austin, TX",
"maxResults": 10,
"enrichProfiles": true,
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": ["RESIDENTIAL"],
"apifyProxyCountry": "US"
}
}
````
***
### Pricing — how much does it cost to scrape Realtor.com agents?
**Pay per event. No subscription.**
| Event | Price | When charged |
| --- | ---: | --- |
| `apify-actor-start` | **$0.005** | When a normal run starts (scaled by allocated memory GB) |
| `apify-default-dataset-item` (`result`) | **$2.50 / 1,000** ($0.0025 each) | Each agent written to the default Dataset |
**User pays platform usage costs: Yes** — compute, residential proxy, and other platform usage are billed to the user in addition to event charges.
**Example product charges (events only):**
| Scenario | Approx. event charge |
| --- | ---: |
| Canary: 10 agents | $0.005 + 10 × $0.0025 = **$0.030** |
| City scan: 100 agents | $0.005 + $0.25 = **$0.255** |
| 1,000 agents | $0.005 + $2.50 = **$2.505** |
Platform usage (especially residential proxy) is separate and depends on run duration and memory.
***
### Input
| Field | Description |
| --- | --- |
| `location` | City and state or ZIP, e.g. `Austin, TX` / `78701` |
| `agentName` | Optional name filter |
| `maxResults` | 1–500 (default 20) |
| `isRealtor` | Restrict to Realtor.com members |
| `minPrice` / `maxPrice` | Optional USD price-band filters |
| `enrichProfiles` | Fetch AgentBranding details (default `true`) |
| `proxyConfiguration` | Apify RESIDENTIAL recommended |
Open the **Input** tab in Console for the full form and tooltips.
***
### Output example
You can download the Dataset as **JSON, CSV, Excel, or HTML**.
```json
{
"agentId": "5678",
"name": "Jane Smith",
"profileUrl": "https://www.realtor.com/realestateagents/jane-smith_austin_tx_5678",
"phone": "5125550100",
"officeName": "Example Realty",
"brokerName": "Example Brokerage",
"averageRating": 4.8,
"reviewsCount": 42,
"forSaleCount": 12,
"recentlySoldCount": 28,
"languages": ["English", "Spanish"],
"specializations": ["Buyer's Agent", "Listing Agent"],
"licenseNumber": "123456",
"source": "realtor.com",
"scrapedAt": "2026-07-17T00:00:00+00:00"
}
```
Core fields include contact (`phone`, `phones`, `officePhones`), brokerage (`officeName`, `brokerName`), ratings, listing stats, `servedAreas`, `languages`, `specializations`, license/MLS, and `profileUrl`.
***
### Live View endpoints
When Standby / Live View is enabled, the Actor exposes a small OpenAPI surface for readiness and discovery:
| Endpoint | Purpose |
| --- | --- |
| `GET /` | Readiness / service info |
| `GET /health` | Health check |
| `GET /input-example` | Low-cost example input |
| `GET /openapi.json` | Deployed OpenAPI document |
Scraping still runs through a **normal Actor run** — Live View does not scrape Realtor.com by itself.
***
### Connect from code
Actor ID: `lentic_clockss/realtor-com-agents-scraper`
```python
from apify_client import ApifyClient
client = ApifyClient("")
run = client.actor("lentic_clockss/realtor-com-agents-scraper").call(
run_input={
"location": "Austin, TX",
"maxResults": 10,
"enrichProfiles": True,
"proxyConfiguration": {
"useApifyProxy": True,
"apifyProxyGroups": ["RESIDENTIAL"],
"apifyProxyCountry": "US",
},
}
)
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item.get("name"), item.get("phone"), item.get("profileUrl"))
```
Use the same Actor ID in Make, n8n, Zapier, or Apify MCP for AI-agent workflows.
***
### FAQ
#### Is there a free Realtor.com agent API?
Realtor.com does not offer a simple public agent-directory API for bulk export. This Actor gives you structured agent profiles through Apify runs, Dataset exports, and integrations.
#### Can I scrape agents by ZIP as well as city?
Yes. Pass a 5-digit US ZIP (e.g. `78701`) or a `City, ST` string. The Actor resolves both through Realtor.com geo suggest.
#### Why is a residential proxy required?
Realtor.com blocks many datacenter and direct IPs. Apify RESIDENTIAL is required for reliable cloud runs.
#### Does enrichProfiles cost more?
Enrichment uses extra GraphQL profile calls and may use more proxy/compute, but event pricing still charges only Actor start + each Dataset item. Platform usage is billed separately when enabled.
#### Can I schedule daily Realtor.com agent scrapes?
Yes. Create an Apify schedule with the same input and send the Dataset to Sheets, Slack, a CRM, or your pipeline.
#### Is it legal to scrape Realtor.com agents?
Use this Actor for legitimate research and outreach only. Respect Realtor.com terms of use and applicable law. Results may include publicly displayed professional contact information; do not use personal data without a lawful basis.
***
### Related Actors
- [Realtor.com Scraper](https://apify.com/lentic_clockss/realtor-com-scraper) — homes for sale and rent listings
- [US Real Estate Scraper](https://apify.com/lentic_clockss/us-real-estate-scraper) — multi-site US aggregation
Browse all Actors: [apify.com/lentic\_clockss](https://apify.com/lentic_clockss)
# Actor input Schema
## `location` (type: `string`):
US city and state or ZIP code, e.g. 'Austin, TX' or '78701'. Resolved via Realtor.com geo suggest before agent search.
## `agentName` (type: `string`):
Optional name or surname filter (e.g. 'smith'). Spaces become hyphens in the Realtor.com name query.
## `maxResults` (type: `integer`):
Maximum agent profiles to collect for the location.
## `isRealtor` (type: `boolean`):
When enabled, restricts results to agents Realtor.com marks as members (is\_realtor).
## `minPrice` (type: `integer`):
Optional minimum listing price filter for agent search.
## `maxPrice` (type: `integer`):
Optional maximum listing price filter for agent search.
## `enrichProfiles` (type: `boolean`):
Fetch AgentBranding profile details (phones, office, MLS, specializations) for each saved agent.
## `proxyConfiguration` (type: `object`):
Apify RESIDENTIAL is always used. Proxy country is derived from the search location. Sticky session keeps one IP for the whole run.
## Actor input object example
```json
{
"location": "Austin, TX",
"agentName": "",
"maxResults": 10,
"isRealtor": false,
"enrichProfiles": true,
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
],
"apifyProxyCountry": "US"
}
}
```
# Actor output Schema
## `agents` (type: `string`):
Normalized Realtor.com agent records with contact and stats fields.
## `runSummary` (type: `string`):
Location, counts, and timestamps for the run.
## `inputEcho` (type: `string`):
Normalized non-secret input for the run.
## `errorSummary` (type: `string`):
Structured failure details when input validation or acquisition fails.
# 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 = {
"location": "Austin, TX",
"maxResults": 10,
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
],
"apifyProxyCountry": "US"
}
};
// Run the Actor and wait for it to finish
const run = await client.actor("lentic_clockss/realtor-com-agents-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 = {
"location": "Austin, TX",
"maxResults": 10,
"proxyConfiguration": {
"useApifyProxy": True,
"apifyProxyGroups": ["RESIDENTIAL"],
"apifyProxyCountry": "US",
},
}
# Run the Actor and wait for it to finish
run = client.actor("lentic_clockss/realtor-com-agents-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 '{
"location": "Austin, TX",
"maxResults": 10,
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
],
"apifyProxyCountry": "US"
}
}' |
apify call lentic_clockss/realtor-com-agents-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=lentic_clockss/realtor-com-agents-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "Realtor.com Agents Scraper - Profiles & Contact Data",
"description": "Scrape Realtor.com agents by US city or ZIP. Extract real estate agent phones, emails, ratings, sales stats, brokerage, languages, and served areas. A Realtor.com agent API alternative for Excel, CSV, or JSON.",
"version": "0.1",
"x-build-id": "TSfWAbQwXXpNdmwee"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/lentic_clockss~realtor-com-agents-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-lentic_clockss-realtor-com-agents-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/lentic_clockss~realtor-com-agents-scraper/runs": {
"post": {
"operationId": "runs-sync-lentic_clockss-realtor-com-agents-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/lentic_clockss~realtor-com-agents-scraper/run-sync": {
"post": {
"operationId": "run-sync-lentic_clockss-realtor-com-agents-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": [
"location"
],
"properties": {
"location": {
"title": "Location",
"maxLength": 120,
"type": "string",
"description": "US city and state or ZIP code, e.g. 'Austin, TX' or '78701'. Resolved via Realtor.com geo suggest before agent search.",
"default": "Austin, TX"
},
"agentName": {
"title": "Agent name filter",
"maxLength": 80,
"type": "string",
"description": "Optional name or surname filter (e.g. 'smith'). Spaces become hyphens in the Realtor.com name query.",
"default": ""
},
"maxResults": {
"title": "Max results",
"minimum": 1,
"maximum": 500,
"type": "integer",
"description": "Maximum agent profiles to collect for the location.",
"default": 20
},
"isRealtor": {
"title": "Realtor.com member only",
"type": "boolean",
"description": "When enabled, restricts results to agents Realtor.com marks as members (is_realtor).",
"default": false
},
"minPrice": {
"title": "Min price ($)",
"minimum": 0,
"type": "integer",
"description": "Optional minimum listing price filter for agent search."
},
"maxPrice": {
"title": "Max price ($)",
"minimum": 0,
"type": "integer",
"description": "Optional maximum listing price filter for agent search."
},
"enrichProfiles": {
"title": "Enrich profiles",
"type": "boolean",
"description": "Fetch AgentBranding profile details (phones, office, MLS, specializations) for each saved agent.",
"default": true
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "Apify RESIDENTIAL is always used. Proxy country is derived from the search location. Sticky session keeps one IP for the whole run."
}
}
},
"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
}
}
}
}
}
}
}
}
}
}
```