# Estately Real Estate Listings Scraper (`parseforge/estately-scraper`) Actor

Scrape MLS-powered residential listings from Estately by city. Returns address, price, beds/baths/sqft, lot size, property type, listing URL, listing image, and geo coordinates per property.

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

## Pricing

from $7.50 / 1,000 mls listing records

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

![ParseForge Banner](https://github.com/ParseForge/apify-assets/blob/ad35ccc13ddd068b9d6cba33f323962e39aed5b2/banner.jpg?raw=true)

## 🏠 Estately Real Estate Listings Scraper

> 🚀 🏠 **Scrape MLS-powered residential listings from Estately.** Pull **hundreds of thousands of US listings** worth of data with **15 fields per record**. No API key, no manual data entry.

> 🕒 **Last updated:** 2026-05-05 · **📊 15 fields per record** · **🌍 United States** · **💵 from $0.008 per item (FREE tier)**

The **Estately Real Estate Listings Scraper** Scrape MLS-powered residential real estate listings from Estately by city URL. Returns address, price, beds, baths, sqft, lot size, property type, primary image, listing URL, and geo coordinates per property. The actor paginates automatically through every page of a city.

| 🎯 Target Audience | 💡 Primary Use Cases |
|---|---|
| Sales teams, compliance officers, researchers, journalists, real-estate analysts, healthcare ops | Local-market intelligence, Real-estate lead generation, Investor underwriting, Map-overlay tools |

---

### 📋 What the Estately Real Estate Listings Scraper does

Highlights of every record returned:

- 🏡 **Property identity.** address, listing URL, listing ID, primary image.
- 💰 **Financial.** list price (USD), sale type, property type.
- 📐 **Specs.** beds, baths, sqft, lot sqft.
- 📍 **Location.** city, state, postal code, lat/lng.
- 🔁 **Auto pagination.** scraper walks every page of the city until maxItems is reached.

> 💡 **Why it matters:** verified, structured data delivered in seconds beats hand-curated spreadsheets that go stale within days. Run this Actor on a schedule and your downstream pipeline always has fresh records.

---

### 🎬 Full Demo

_🚧 Coming soon: a 3-minute walkthrough showing how to go from sign-up to a downloaded Estately Real Estate Listings Scraper dataset._

---

### ⚙️ Input

<table>
<thead><tr><th>Input</th><th>Type</th><th>Default</th><th>Behavior</th></tr></thead>
<tbody>
<tr><td><code>cityUrl</code></td><td>string</td><td><code>required</code></td><td>Estately city URL or path-only (e.g., `CA/Los_Angeles`).</td></tr>
<tr><td><code>fetchDetails</code></td><td>boolean</td><td><code>false</code></td><td>When true, visits each listing's detail page for richer geo/address.</td></tr>
<tr><td><code>maxItems</code></td><td>integer</td><td><code>10</code></td><td>Records to return. Free: max 10. Paid: up to 1,000,000.</td></tr>
</tbody>
</table>

**Example input:**

```json
{
    "cityUrl": "https://www.estately.com/CA/Los_Angeles",
    "maxItems": 200
}
````

***

### 📊 Output

Each record contains **15 fields**. Download the dataset as CSV, Excel, JSON, or XML.

#### 🧾 Top fields

- `address`
- `url`
- `imageUrl`
- `priceUsd`
- `saleType`
- `propertyType`
- `beds`
- `baths`
- `sqft`
- `city`
- `state`
- `lat`
- `lng`

***

### ✨ Why choose this Actor

- 🛠️ **No infrastructure** to maintain. The Apify cloud handles scheduling, retries, proxies, and storage.
- 🌍 **Verified source data.** Records come from authoritative public sources, not third-party aggregators.
- 🔁 **Repeatable runs.** Schedule monthly, weekly, or hourly to keep your pipeline always fresh.
- 📊 **Multiple export formats.** CSV, Excel, JSON, XML out of the box.
- 💵 **Pay only for what you use.** Pay-per-result-item pricing, free preview included.

***

### 💼 Business use cases

#### 📊 Local-market intelligence

Track median price, beds, and sqft by city, ZIP, or property type.

#### 🤝 Real-estate lead generation

Build a target list of listings by city, price band, and property type.

#### 📈 Investor underwriting

Pull comparables for a target neighborhood with full geo for radius search.

#### 🌐 Map-overlay tools

Power GIS dashboards with verified MLS coordinates and property characteristics.

***

### 📈 How it compares to alternatives

| Approach | Cost | Coverage | Refresh | Filters | Setup |
|---|---|---|---|---|---|
| **⭐ Estately Real Estate Listings Scraper** *(this Actor)* | $5 free credit, then pay-per-use | Full source coverage | **Live per run** | Source-native filters supported | ⚡ 2 min |
| Build your own scraper | Engineering hours | Full once built | Whenever you maintain it | Custom code | 🐢 Days to weeks |
| Paid managed APIs | $$$ monthly | Vendor-defined | Live | Vendor-defined | ⏳ Hours |
| Third-party data dumps | Varies | Subset, often stale | Periodic | None | 🕒 Variable |

Pick this Actor when you want broad coverage, server-side filtering, and no pipeline maintenance.

***

### 🚀 How to use

1. [Create a free account](https://console.apify.com/sign-up?fpr=vmoqkp) on Apify (includes $5 in free credit).
2. Open the **Estately Real Estate Listings Scraper** Actor page.
3. Fill out the input form and click **Start**.
4. Download your dataset in CSV, Excel, JSON, or XML.

***

### 🌟 Beyond business use cases

#### 🎓 Research and academia

Urban-planning researchers can study housing density, lot-size distribution, and price gradients across cities.

#### 🎨 Personal and creative

Home buyers can build personal saved-search lists with custom filters not available on the consumer site.

#### 🤝 Non-profit and civic

Affordable-housing advocates can monitor price stratification by neighborhood.

#### 🧪 Experimentation

Data scientists can use sqft + beds + price as a regression benchmark for housing-market models.

***

### 🤖 Ask an AI assistant about this scraper

Open a ready-to-send prompt about this ParseForge actor in the AI of your choice:

- 💬 [**ChatGPT**](https://chat.openai.com/?q=How%20do%20I%20use%20the%20%F0%9F%8F%A0%20Estately%20Real%20Estate%20Listings%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.)
- 🧠 [**Claude**](https://claude.ai/new?q=How%20do%20I%20use%20the%20%F0%9F%8F%A0%20Estately%20Real%20Estate%20Listings%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.)
- 🔍 [**Perplexity**](https://perplexity.ai/search?q=How%20do%20I%20use%20the%20%F0%9F%8F%A0%20Estately%20Real%20Estate%20Listings%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.)
- 🅒 [**Copilot**](https://copilot.microsoft.com/?q=How%20do%20I%20use%20the%20%F0%9F%8F%A0%20Estately%20Real%20Estate%20Listings%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.)

***

### ❓ Frequently Asked Questions

#### Where does the data come from?

From `estately.com` city pages, which embed MLS-listed residential properties via JSON-LD `Residence` schema.

#### How do I find a city URL?

Browse Estately, navigate to the city of interest, and copy the URL. The path follows `STATE/City_Name` (e.g., `CA/Los_Angeles`, `TX/Austin`).

#### Are price history and tax data included?

No. The actor returns the current listing snapshot (price, beds, baths, sqft, image, geo). Price history would require a slower per-listing detail scrape.

#### Are agent contact details included?

No. The actor focuses on property-level data; agent contacts vary by MLS and are not consistently exposed.

#### How fresh is the data?

Records are scraped in real time. Estately syncs MLS feeds daily.

***

### 🔌 Integrate with any app

Connect this Actor to your stack via the [Apify integrations](https://docs.apify.com/platform/integrations) catalog:

- 📊 **Make / Zapier / n8n**  -  trigger scrapes from any business workflow.
- 💬 **Slack / Discord**  -  get a notification when a run finishes.
- 📁 **Google Drive / Google Sheets**  -  push the dataset directly into a spreadsheet.
- 📨 **Gmail / Mailchimp / HubSpot**  -  automate outreach with the scraped leads.
- 🔌 **Apify CLI / SDK**  -  programmatic control from Python, Node.js, or any HTTP client.
- ⚡ **Webhooks**  -  POST run results to any endpoint when complete.

***

### 🔗 Recommended Actors

- 🔧 [**Zillow Scraper**](https://apify.com/parseforge/zillow-scraper)
- 🔧 [**Realtor.com Scraper**](https://apify.com/parseforge/realtor-com-scraper)
- 🔧 [**Apartments.com Scraper**](https://apify.com/parseforge/apartments-com-scraper)
- 🔧 [**Redfin Scraper**](https://apify.com/parseforge/redfin-scraper)
- 🔧 [**LoopNet Scraper**](https://apify.com/parseforge/loopnet-real-estate-scraper)

***

> **Disclaimer:** This Actor scrapes only publicly accessible data. We do not collect personal information beyond what is voluntarily published by the source. Do not use the data for unauthorized contact, spam, or any purpose violating applicable laws or the source site's Terms of Service. Respect [GDPR](https://gdpr.eu/), [CCPA](https://oag.ca.gov/privacy/ccpa), and applicable consumer-protection laws. ParseForge is not affiliated with any source site.

***

**🆘 Need Help?** [**Open our contact form**](https://tally.so/r/BzdKgA) to request a new scraper, propose a custom data project, or report an issue.

# Actor input Schema

## `cityUrl` (type: `string`):

Estately city URL (e.g., 'https://www.estately.com/CA/Los\_Angeles') or path-only ('CA/Los\_Angeles').

## `fetchDetails` (type: `boolean`):

If true, visit each listing's detail page for richer data (slower, more requests).

## `maxItems` (type: `integer`):

Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000

## Actor input object example

```json
{
  "cityUrl": "https://www.estately.com/CA/Los_Angeles",
  "fetchDetails": false,
  "maxItems": 10
}
```

# Actor output Schema

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

No description

# 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 = {
    "cityUrl": "https://www.estately.com/CA/Los_Angeles",
    "maxItems": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("parseforge/estately-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 = {
    "cityUrl": "https://www.estately.com/CA/Los_Angeles",
    "maxItems": 10,
}

# Run the Actor and wait for it to finish
run = client.actor("parseforge/estately-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 '{
  "cityUrl": "https://www.estately.com/CA/Los_Angeles",
  "maxItems": 10
}' |
apify call parseforge/estately-scraper --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Estately Real Estate Listings Scraper",
        "description": "Scrape MLS-powered residential listings from Estately by city. Returns address, price, beds/baths/sqft, lot size, property type, listing URL, listing image, and geo coordinates per property.",
        "version": "1.0",
        "x-build-id": "oRIr2uqcavYQ4PQwR"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/parseforge~estately-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-parseforge-estately-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/parseforge~estately-scraper/runs": {
            "post": {
                "operationId": "runs-sync-parseforge-estately-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/parseforge~estately-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-parseforge-estately-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": [
                    "cityUrl"
                ],
                "properties": {
                    "cityUrl": {
                        "title": "City URL or path",
                        "type": "string",
                        "description": "Estately city URL (e.g., 'https://www.estately.com/CA/Los_Angeles') or path-only ('CA/Los_Angeles')."
                    },
                    "fetchDetails": {
                        "title": "Fetch detail pages",
                        "type": "boolean",
                        "description": "If true, visit each listing's detail page for richer data (slower, more requests).",
                        "default": false
                    },
                    "maxItems": {
                        "title": "Max Items",
                        "minimum": 1,
                        "maximum": 1000000,
                        "type": "integer",
                        "description": "Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000"
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
