# Realtor Rental Insights (`realtorscraper/realtor-rental-data`) Actor

Efficiently extracts rental property data from Realtor.com, including prices, locations, property details, availability, and media assets. Ideal for real estate professionals, investors, and analysts seeking structured, up-to-date rental market insights.

- **URL**: https://apify.com/realtorscraper/realtor-rental-data.md
- **Developed by:** [Realtor Scraper](https://apify.com/realtorscraper) (community)
- **Categories:** Real estate
- **Features:** Limited permissions
- **Stats:** 106 total users, 0 monthly users, 100.0% runs succeeded, 1 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.12 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## 🏡 Realtor Rental Insights

**Unlock real-time rental market intelligence with HomeHarvester — a high-performance scraper built to extract structured rental data directly from [Realtor.com](https://www.realtor.com/).**\
Designed for **real estate professionals**, **investors**, and **market analysts**, it helps you gather, analyze, and visualize property listings across multiple U.S. cities in seconds.

***

### 🚀 Overview

HomeHarvester is an advanced data extraction actor that connects to Realtor.com’s public property listings to deliver clean, structured rental data.\
It supports **multi-location scraping**, **advanced filtering**, and **pagination control**, ensuring you capture every relevant property that fits your research or business criteria.

***

### ✨ Key Features

- ⚡ **Blazing Fast Scraping** — Parallel processing for multiple cities and states
- 🎯 **Advanced Query Filters** — Target by property type, rent specials, or pet policies
- 🌎 **Multi-Region Support** — Collect listings from multiple U.S. regions in a single run
- 🖼️ **Media-Rich Output** — Extract photos, 3D virtual tours, and other media assets
- 📦 **Structured JSON Output** — Developer-friendly data ready for analysis or integration
- 🔄 **Pagination Support** — Retrieve listings across hundreds of pages automatically
- 🧠 **Smart Sorting Options** — Sort by lowest price, newest listings, or highest price

***

### 🧩 Ideal Use Cases

- **Real Estate Analysts** — Track pricing and availability across states
- **Property Managers** — Benchmark competitor listings and rent trends
- **Investors** — Identify high-yield rental opportunities
- **Data Scientists** — Feed structured data into ML or BI systems
- **Market Researchers** — Gather insights for market forecasting and reports

***

### 🗂️ Data You’ll Get

Each property record from Realtor.com includes:

#### 📍 Location Details

- Full address (street, city, state, ZIP)
- County name and geographic coordinates (latitude, longitude)

#### 🏘️ Property Info

- Property ID and Listing ID
- Property name and type (apartment, condo, townhome, single-family)
- Bedrooms, bathrooms, square footage
- Price range and rent specials

#### 💰 Pricing & Availability

- Current rent or rent range
- Price reduction status
- Move-in date or availability

#### 🐾 Features & Policies

- Pet policy (dogs, cats, restrictions)
- Key amenities and building highlights
- Application eligibility

#### 🖼️ Media

- Primary image URL
- Up to 3 additional images
- Virtual or Matterport 3D tour link

#### 🏢 Management

- Property manager or advertiser info
- Contact details and listing source

***

### ⚙️ Input Configuration

You can customize scraping parameters via JSON input.

#### Basic Example

```json
{
  "locations": ["Miami", "Orlando"],
  "property_type": "apartment",
  "page_count": 2
}
```

#### Advanced Example

```json
{
  "locations": ["California", "Texas", "Florida"],
  "property_type": "single family",
  "sort_by": "lowest price",
  "page_count": 5,
  "pet_friendly": true,
  "rent_specials": true
}
```

***

### 🧠 Input Parameters

| Parameter | Type | Required | Description | Example |
|------------|------|----------|-------------|----------|
| `locations` | Array | ✅ Yes | List of cities or states to scrape | `["Austin", "Denver"]` |
| `property_type` | String | No | Type of property | `apartment`, `condo`, `single family` |
| `sort_by` | String | No | Sort order | `highest price`, `lowest price`, `newest` |
| `page_count` | Integer | No | Number of pages to scrape (max 100) | `10` |
| `pet_friendly` | Boolean | No | Include pet-friendly listings | `true` |
| `rent_specials` | Boolean | No | Include rent-special offers | `true` |
| `apply_now` | Boolean | No | Show listings with online applications | `true` |

***

### 🧾 Output Format

HomeHarvester outputs clean JSON data, ideal for databases, dashboards, or analytical workflows.

```json
{
  "property_id": "9816250601",
  "listing_id": "2977153881",
  "property_type": "apartment",
  "price_min": 1070,
  "price_max": 1350,
  "address": "121 NW 7th Ave, Miami, FL 33128",
  "coordinates": {"lat": 25.7749, "lon": -80.2059},
  "photos": ["https://...", "https://..."],
  "pet_policy": {"cats": true, "dogs": false},
  "amenities": ["gym", "pool", "parking"],
  "available_date": "2025-01-03",
  "search_location": "Miami"
}
```

***

### 💡 Best Practices

1. Start with 1–2 cities to test configuration.
2. Use specific city names for more accurate results.
3. Combine filters like `pet_friendly` + `rent_specials` for better targeting.
4. Larger page counts increase runtime — use wisely.
5. Export data as JSON, CSV, or Excel for easy analysis.

***

### 🧠 Example Use Cases

#### Market Analysis

Compare average rents across major U.S. cities for 2-bedroom apartments.

#### Property Benchmarking

Monitor pricing changes among similar listings weekly.

#### Investment Insights

Identify undervalued properties and analyze rent-to-price ratios.

***

### 📈 Performance

- **Speed:** Concurrent scraping for multiple regions
- **Scalability:** 100+ pages per location supported
- **Accuracy:** Real-time data from Realtor.com
- **Quality:** Duplicate-free, structured JSON

***

### 🛡️ Data Reliability

- ✅ Verified from Realtor.com listings
- ✅ Real-time property information
- ✅ Structured and deduplicated records
- ✅ Supports nationwide U.S. coverage

***

### 🧭 Why HomeHarvester?

| Feature | Description |
|----------|-------------|
| ⚡ **High-Speed Extraction** | Asynchronous scraping for faster results |
| 🧠 **Smart Filtering** | Powerful query control for precision |
| 🧩 **Developer Friendly** | Simple input → structured JSON output |
| 🌎 **Scalable** | Scrape multiple states or regions seamlessly |
| 💾 **Flexible Export** | JSON, CSV, or database ingestion ready |

***

# Actor input Schema

## `locations` (type: `array`):

List of locations to search (e.g., Florida, Miami, Orlando)

## `property_type` (type: `string`):

Type of property to search for

## `sort_by` (type: `string`):

Sort option for results

## `page_count` (type: `integer`):

Number of pages to scrape (42 results per page)

## `rent_specials` (type: `boolean`):

Filter for properties with rent specials

## `apply_now` (type: `boolean`):

Filter for properties with online application

## `pet_friendly` (type: `boolean`):

Filter for pet-friendly properties

## Actor input object example

```json
{
  "locations": [
    "Florida",
    "Miami",
    "Orlando"
  ],
  "property_type": "any",
  "sort_by": "best match",
  "page_count": 1,
  "rent_specials": false,
  "apply_now": false,
  "pet_friendly": false
}
```

# 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 = {
    "locations": [
        "Florida"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("realtorscraper/realtor-rental-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 = { "locations": ["Florida"] }

# Run the Actor and wait for it to finish
run = client.actor("realtorscraper/realtor-rental-data").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "locations": [
    "Florida"
  ]
}' |
apify call realtorscraper/realtor-rental-data --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,realtorscraper/realtor-rental-data"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/2pUQaGdaA538yhmE9/builds/ag3KtwcRh06sV67kL/openapi.json
