# Realtor.com Scraper - Homes for Sale & Rent Data (`lentic_clockss/realtor-com-scraper`) Actor
Scrape Realtor.com for-sale and rental listings by US city. Extract prices, beds, baths, sqft, MLS details, agents, photos, pet policy, floorplans, and fees. A Realtor.com API alternative for Excel, CSV, or JSON export.
- **URL**: https://apify.com/lentic\_clockss/realtor-com-scraper.md
- **Developed by:** [kane liu](https://apify.com/lentic_clockss) (community)
- **Categories:** Real estate, Lead generation, Automation
- **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet
## Pricing
from $2.80 / 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 Scraper — Homes for Sale & Rent
**Scrape Realtor.com for-sale and rental listings by US city — then download structured real estate data as Excel, CSV, or JSON.**
This Actor is a practical **Realtor.com API alternative** for market research, investor screening, rental comps, and lead lists. Enter a city such as `Austin, TX`, choose **For sale**, **For rent**, or **Both**, and get listing rows with prices, beds, baths, sqft, MLS source, agents, photos, pet policy, floorplans, and fees when present on the detail page.
- Pull **homes for sale** and **apartments for rent** from [Realtor.com](https://www.realtor.com/)
- Enrich search results with **detail-page fields** (MLS, advertisers, photos, HOA, open houses, pet policy, floorplans)
- Filter by property type and price range — or paste known **detail URLs**
- Export to **Excel / CSV / JSON**, or connect Make, n8n, Zapier, Python, or MCP
- **Pay per event** — Actor start + each Dataset listing; no subscription
---
### What does the Realtor.com Scraper do?
It turns a US city search on Realtor.com into a clean Apify Dataset of property listings.
Under the hood, the Actor:
1. Builds the Realtor.com search URL for your city and listing type
2. Collects listing cards from the search results page
3. Opens detail pages to enrich each row with MLS, agents, photos, and rental extras
4. Writes normalized records you can download or push into automations
Residential US proxy is required (prefilled). Fetching uses **Camoufox** as primary with **CloakBrowser** fallback — plain HTTP is not used (CloudFront 429).
---
### What data can you extract from Realtor.com?
| Data point | For sale | For rent |
| --- | :---: | :---: |
| Address / listing name | ✅ | ✅ |
| List price or rent range | ✅ | ✅ |
| Beds / baths / sqft | ✅ | ✅ |
| Property type & status | ✅ | ✅ |
| GPS coordinates | ✅ | ✅ |
| Listing URL & main image | ✅ | ✅ |
| MLS / source metadata | ✅ | ✅ |
| Agents / advertisers | ✅ | ✅ |
| Photo gallery | ✅ | ✅ |
| HOA / open houses | ✅ | — |
| Pet policy / specials / fees / floorplans | — | ✅ |
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. Scrape homes for sale in a metro
Enter a city like `Austin, TX`, set listing type to **For sale**, and get structured rows with price, beds, baths, sqft, year built, MLS source, and a direct listing URL — ready for comps or investor shortlists.
#### 2. Scrape rental communities and apartments
Set listing type to **For rent**. Rows include rent range (`listPriceMin` / `listPriceMax`), bed/bath ranges, pet policy, specials, one-time fees, and floorplans when present on the detail page.
#### 3. Enrich known Realtor.com detail URLs
Paste one or more Realtor.com detail URLs into **Detail URLs** to skip search and fetch full `propertyDetails` directly.
#### 4. Feed real estate 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 (no code required)
1. Click **Try for free**
2. Enter a location (`Austin, TX`)
3. Choose **For sale**, **For rent**, or **Both**
4. Optionally set max results, property type, and price filters
5. Keep **Apify RESIDENTIAL** proxy enabled (US recommended)
6. 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",
"listingType": "sale",
"maxResults": 10,
"propertyType": "house",
"maxPrice": 800000,
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": ["RESIDENTIAL"],
"apifyProxyCountry": "US"
}
}
````
***
### Pricing — how much does it cost to scrape Realtor.com?
**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.80 / 1,000** ($0.0028 each) | Each listing 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 listings | $0.005 + 10 × $0.0028 = **$0.033** |
| City scan: 100 listings | $0.005 + $0.28 = **$0.285** |
| 1,000 listings | $0.005 + $2.80 = **$2.805** |
Platform usage (especially residential proxy) is separate and depends on run duration and memory.
***
### Input
| Field | Description |
| --- | --- |
| `location` | City and state, e.g. `Austin, TX` |
| `listingType` | `sale`, `rent`, or `both` |
| `maxResults` | 1–200 (default 20) |
| `propertyType` | Optional: house, condo, townhouse, apartment, land |
| `minPrice` / `maxPrice` | Optional USD filters |
| `detailUrls` | Optional detail page URLs (skips search) |
| `proxyConfiguration` | Apify RESIDENTIAL / US 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
{
"name": "123 Main St, Austin, TX 78701",
"listingType": "sale",
"status": "for_sale",
"type": "house",
"city": "Austin",
"state": "TX",
"listPrice": 725000,
"beds": 3,
"baths": 2,
"sqft": 1840,
"authority": "ACTRIS",
"listingUrl": "https://www.realtor.com/realestateandhomes-detail/...",
"source": "realtor.com",
"scrapedAt": "2026-07-17T00:00:00+00:00"
}
```
Core fields include preview fields (`name`, `type`, `status`, `country`, `authority`), address/price/size/GPS, `listingUrl`, `imageUrl`, plus detail extras such as `flags`, `sourceMeta`, `advertisers`, `photos`, `hoa`, `openHouses` (sale), and `petPolicy`, `specials`, `floorplans`, `oneTimeFees` (rent).
***
### 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-scraper`
```python
from apify_client import ApifyClient
client = ApifyClient("")
run = client.actor("lentic_clockss/realtor-com-scraper").call(
run_input={
"location": "Austin, TX",
"listingType": "sale",
"maxResults": 10,
"proxyConfiguration": {
"useApifyProxy": True,
"apifyProxyGroups": ["RESIDENTIAL"],
"apifyProxyCountry": "US",
},
}
)
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item.get("name"), item.get("listPrice"), item.get("listingUrl"))
```
Use the same Actor ID in Make, n8n, Zapier, or Apify MCP for AI-agent workflows.
***
### FAQ
#### Is there a free Realtor.com API?
Realtor.com does not offer a simple public listing API for bulk export. This Actor gives you structured for-sale and rental data through Apify runs, Dataset exports, and integrations.
#### Can I scrape both for-sale and rental listings?
Yes. Set `listingType` to `both`. `maxResults` is split across sale and rent when both are selected.
#### Why is a residential proxy required?
Realtor.com blocks many datacenter and direct IPs (CloudFront 429). Apify RESIDENTIAL with a country matched to the search location is required for reliable runs.
#### Can I schedule daily Realtor.com 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?
Use this Actor for legitimate research and analysis only. Respect Realtor.com terms of use and applicable law. Results may include publicly displayed listing information; do not use personal data without a lawful basis.
***
### Related Actors
- [US Real Estate Scraper](https://apify.com/lentic_clockss/us-real-estate-scraper) — multi-site US aggregation (Zillow, Redfin, Realtor, Zumper, Apartments.com)
Browse all Actors: [apify.com/lentic\_clockss](https://apify.com/lentic_clockss)
# Actor input Schema
## `location` (type: `string`):
US city and state, e.g. 'Austin, TX' or 'San Francisco, CA'. Converted to Realtor.com slug (Austin\_TX).
## `listingType` (type: `string`):
Scrape for-sale listings, rentals, or both.
## `maxResults` (type: `integer`):
Maximum listings to collect (split evenly across sale and rent when listingType is both).
## `propertyType` (type: `string`):
Optional property-type filter for search URLs. Leave empty for all types.
## `minPrice` (type: `integer`):
Optional minimum list price or rent in USD.
## `maxPrice` (type: `integer`):
Optional maximum list price or rent in USD.
## `detailUrls` (type: `array`):
Optional Realtor.com detail page URLs. When set, search is skipped and these pages are enriched directly.
## `proxyConfiguration` (type: `object`):
Apify RESIDENTIAL is always used. Proxy country is derived from the search location (e.g. Austin, TX → US) so the exit IP matches the market. Sticky session keeps one IP for the whole run.
## Actor input object example
```json
{
"location": "Austin, TX",
"listingType": "sale",
"maxResults": 10,
"propertyType": "",
"detailUrls": [],
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
],
"apifyProxyCountry": "US"
}
}
```
# Actor output Schema
## `listings` (type: `string`):
Normalized Realtor.com listing records with detail-page fields.
## `runSummary` (type: `string`):
Location, listing type, 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",
"listingType": "sale",
"maxResults": 10,
"detailUrls": [],
"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-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",
"listingType": "sale",
"maxResults": 10,
"detailUrls": [],
"proxyConfiguration": {
"useApifyProxy": True,
"apifyProxyGroups": ["RESIDENTIAL"],
"apifyProxyCountry": "US",
},
}
# Run the Actor and wait for it to finish
run = client.actor("lentic_clockss/realtor-com-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",
"listingType": "sale",
"maxResults": 10,
"detailUrls": [],
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
],
"apifyProxyCountry": "US"
}
}' |
apify call lentic_clockss/realtor-com-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=lentic_clockss/realtor-com-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "Realtor.com Scraper - Homes for Sale & Rent Data",
"description": "Scrape Realtor.com for-sale and rental listings by US city. Extract prices, beds, baths, sqft, MLS details, agents, photos, pet policy, floorplans, and fees. A Realtor.com API alternative for Excel, CSV, or JSON export.",
"version": "0.1",
"x-build-id": "xnzSyXDjMu2SeId5W"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/lentic_clockss~realtor-com-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-lentic_clockss-realtor-com-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-scraper/runs": {
"post": {
"operationId": "runs-sync-lentic_clockss-realtor-com-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-scraper/run-sync": {
"post": {
"operationId": "run-sync-lentic_clockss-realtor-com-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, e.g. 'Austin, TX' or 'San Francisco, CA'. Converted to Realtor.com slug (Austin_TX).",
"default": "Austin, TX"
},
"listingType": {
"title": "Listing type",
"enum": [
"sale",
"rent",
"both"
],
"type": "string",
"description": "Scrape for-sale listings, rentals, or both.",
"default": "sale"
},
"maxResults": {
"title": "Max results",
"minimum": 1,
"maximum": 200,
"type": "integer",
"description": "Maximum listings to collect (split evenly across sale and rent when listingType is both).",
"default": 20
},
"propertyType": {
"title": "Property type",
"enum": [
"",
"house",
"condo",
"townhouse",
"apartment",
"land"
],
"type": "string",
"description": "Optional property-type filter for search URLs. Leave empty for all types.",
"default": ""
},
"minPrice": {
"title": "Min price ($)",
"minimum": 0,
"type": "integer",
"description": "Optional minimum list price or rent in USD."
},
"maxPrice": {
"title": "Max price ($)",
"minimum": 0,
"type": "integer",
"description": "Optional maximum list price or rent in USD."
},
"detailUrls": {
"title": "Detail URLs (optional)",
"type": "array",
"description": "Optional Realtor.com detail page URLs. When set, search is skipped and these pages are enriched directly.",
"default": [],
"items": {
"type": "string"
}
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "Apify RESIDENTIAL is always used. Proxy country is derived from the search location (e.g. Austin, TX → US) so the exit IP matches the market. 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
}
}
}
}
}
}
}
}
}
}
```