# Homes Property Scraper (`agentx/homes-property-scraper`) Actor

Search Homes.com listings in the United States. Extract sale and rental property data with prices, beds, baths, area, images, listing details, agent data, and source URLs.

- **URL**: https://apify.com/agentx/homes-property-scraper.md
- **Developed by:** [AgentX](https://apify.com/agentx) (community)
- **Categories:** Real estate, Developer tools, Automation
- **Stats:** 1 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $7.65 / 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/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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

> **Affiliate disclosure:** Actor links in this documentation may include an Apify referral parameter at no additional cost to you.

## Homes Property Scraper - Homes.com Property Listings Data API

**Homes Property Scraper extracts structured Homes.com listing data from United States markets for real estate analytics, lead generation, pricing research, and property intelligence workflows.** It returns 40 normalized fields for sale and rental property records, including prices, beds, baths, area, images, listing details, agent data, source URLs, and processing metadata. Property type remains optional; listing type defaults to sale when omitted.

[![Property Data](https://img.shields.io/badge/Property_Data-ffd700?style=for-the-badge\&color=ffd700)](https://apify.com/agentx/homes-property-scraper?fpr=aiagentapi) [![Pay Per Result](https://img.shields.io/badge/Pay_Per_Result-ffd700?style=for-the-badge\&color=ffd700)](https://apify.com/agentx/homes-property-scraper?fpr=aiagentapi) [![United States](https://img.shields.io/badge/United_States-ffd700?style=for-the-badge\&color=ffd700)](https://apify.com/agentx/homes-property-scraper?fpr=aiagentapi)

***

### Why Choose This API

#### Homes.com Listing Intelligence for United States Property Workflows

**🏠 Sale and Rental Listing Coverage**
Collect Homes.com property listings for `for_sale` and `for_rent` workflows in supported United States locations.

**📍 Location-Based Search**
Search by city, region, neighborhood, postal code, or address supported by Homes.com.

**📊 Normalized Property Records**
Return 40 consistent fields covering price, rooms, area, land, address, geo data, media, features, contacts, source URLs, and processing metadata.

**🏘️ Residential Property Filters**
Use optional property type filters such as residential, house, apartment, condo, or townhouse.

***

### Quick Start Guide

#### How to Extract Homes.com Property Data in 3 Steps

##### Step 1: Configure Your Request

Open [Homes Property Scraper](https://apify.com/agentx/homes-property-scraper?fpr=aiagentapi) and enter max results, country, and location.

##### Step 2: Add Optional Filters

Choose listing type and property type only when those filters are needed.

##### Step 3: Run and Export

Click **Start** and export the default dataset as JSON, CSV, Excel, XML, RSS, or through the Apify API.

***

### Input Parameters

| Parameter | Type | Required | Description | Example |
| --- | --- | --- | --- | --- |
| `max_results` | integer | Yes | Maximum number of Homes.com property listings to return. | `10` |
| `country` | string | Yes | Country where Homes.com listings are supported. | `United States` |
| `location` | string | Yes | City, region, neighborhood, postal code, or address supported by Homes.com. | `Miami, FL` |
| `listing_type` | string | No | Transaction status to search: `for_sale` or `for_rent`. | `for_sale` |
| `property_type` | string | No | Optional property or asset type filter. | `house` |

***

### Output Data Schema

| Field Group | Examples |
| --- | --- |
| Listing details | platform, title, description, listing\_id, mls\_id, listing\_type, availability, market\_type, property\_type, subtype, category, business\_type |
| Pricing, dimensions, and dates | price, rooms, area, land, building, dates, posted\_time, fees |
| Location | location, address, geo, country, nearby |
| Media and features | cover\_image, image\_urls, media, open\_houses, features, amenities, details |
| Community and unit data | reviews, policies, units |
| Contacts and source links | contact, source\_url, official\_url |
| Processing metadata | processor, processed\_at |

***

### Integration Examples

#### Actor ID

```text
RRHhhMhNMDVcPxuml
```

#### REST API

```text
POST https://api.apify.com/v2/acts/RRHhhMhNMDVcPxuml/run-sync-get-dataset-items?token=YOUR_API_TOKEN
Content-Type: application/json
```

#### JavaScript SDK

```javascript
import { ApifyClient } from "apify-client";

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor("RRHhhMhNMDVcPxuml").call({
  max_results: 10,
  country: "United States",
  location: "Miami, FL",
  listing_type: "for_sale",
  property_type: "house",
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);
```

#### JSON-LD Metadata

```json
{
  "@context": "https://schema.org",
  "@type": "SoftwareApplication",
  "name": "Homes Property Scraper",
  "description": "Homes.com property listings data API for United States sale and rental records.",
  "applicationCategory": "BusinessApplication",
  "applicationSubCategory": "Real Estate Data API",
  "operatingSystem": "Web, Cloud",
  "url": "https:\/\/apify.com\/agentx\/homes-property-scraper?fpr=aiagentapi",
  "dateModified": "2026-07-21",
  "featureList": [
    "Homes.com sale and rental listing searches",
    "40 normalized property fields",
    "Optional residential property-type filters",
    "JSON, CSV, Excel, and API exports"
  ]
}
```

***

### Pricing & Cost Calculator

| Event | Price | Description |
| --- | --- | --- |
| Actor Start | $0.01000 | Charged when the Actor starts running. |
| Result | $0.00850 FREE / $0.00822 BRONZE / $0.00793 SILVER / $0.00765 GOLD+ | Charged for each result saved to the default dataset. |

At the FREE result tier, 100 results cost **$0.86** including one Actor Start event. One thousand results cost **$8.51** including one Actor Start event.

***

### Use Cases & Applications

- United States sale and rental property monitoring.
- Comparable listing research and price benchmarking.
- Agent, owner, landlord, or developer prospecting.
- Property intelligence datasets for dashboards and enrichment workflows.

***

### FAQ

#### Which country is supported?

The Actor is scoped to the United States and accepts cities, regions, neighborhoods, postal codes, or addresses that Homes.com can resolve.

#### Which listing types are supported?

Use `for_sale` or `for_rent`. If omitted, the runtime uses `for_sale`.

#### Does this Actor support posted\_since?

No. The current Homes.com request path does not provide a reliable posted-date filter, so the public input intentionally omits it.

#### Does property\_type have a hidden default?

No. Leave it empty to avoid narrowing the search. Supported values are `residential`, `house`, `apartment`, `condo`, and `townhouse`.

#### Are all 40 fields always populated?

No. The schema remains stable, while unavailable source values remain empty or null.

#### Is the data real-time?

Results reflect Homes.com data available when the run executes. Stored examples and historical online statistics may be stale.

***

### SEO Keywords & Search Terms

Homes.com property scraper, Homes scraper API, US property listings data, homes for sale API, rental listings data, comparable property research, real estate monitoring, housing market data export

***

### Trust & Certifications

- ✅ **Schema-aligned output** — published items use the documented 40-field property structure.
- ✅ **Input-surface accuracy** — only runtime-supported country, listing, and property filters are exposed.
- ✅ **Source traceability** — records include Homes.com source URLs and processing timestamps when available.
- ✅ **Transparent billing** — Actor Start and Result events are documented above.
- ✅ **Current-run evidence** — live run output is authoritative; older online data is only historical context.

***

### Legal & Compliance

> **Important:** [Homes.com's Terms of Use](https://www.homes.com/about/homesterms-of-use/) prohibit scraping, data-mining or extraction tools, robots, spiders, and other processes used to monitor or copy the product or its data without the company's express written permission. Do not run this Actor against Homes.com unless you have obtained every permission required for your intended access and use.

Users are responsible for complying with applicable laws, contracts, platform terms, privacy obligations, intellectual-property rights, MLS restrictions, and any authorization that applies to them. Public visibility does not itself grant permission to automate collection or reuse listing content. Homes.com is a trademark of its respective owner; this independent Actor is not endorsed by or affiliated with Homes.com.

Verify prices, availability, contacts, and listing status against the returned `source_url` before making material decisions.

***

### Related Tools

**Related:** [Zillow Property Scraper](https://apify.com/agentx/zillow-property-scraper?fpr=aiagentapi) · [Realtor Property Scraper](https://apify.com/agentx/realtor-property-scraper?fpr=aiagentapi) · [MagicBricks Property Scraper](https://apify.com/agentx/magicbricks-property-scraper?fpr=aiagentapi)

**Enrich:** [All Property Scraper](https://apify.com/agentx/all-property-scraper?fpr=aiagentapi) · [All Jobs Scraper](https://apify.com/agentx/all-jobs-scraper?fpr=aiagentapi) · [All Shopping Scraper](https://apify.com/agentx/all-shopping-scraper?fpr=aiagentapi)

Support: <https://t.me/AiAgentApi>

***

### Support & Community

- **Actor page:** [Homes Property Scraper](https://apify.com/agentx/homes-property-scraper?fpr=aiagentapi)
- **Community:** [@Apify\_Actor](https://t.me/Apify_Actor)
- **Contact team:** [@AiAgentApi](https://t.me/AiAgentApi)

***

**Last Updated:** 2026-07-21

# Actor input Schema

## `max_results` (type: `integer`):

Maximum number of Homes.com property listings to return

## `country` (type: `string`):

Country where Homes.com listings will be searched

## `location` (type: `string`):

City, region, neighborhood, postal code, or address supported by Homes.com

## `listing_type` (type: `string`):

Choose the transaction status to search

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

Optional property or asset type filter. Leave empty to include all supported property types

## Actor input object example

```json
{
  "max_results": 10,
  "country": "United States",
  "location": "Miami, FL"
}
```

# Actor output Schema

## `results` (type: `string`):

Overview table for the default dataset of normalized property listings.

# 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 = {
    "max_results": 10,
    "country": "United States",
    "location": "Miami, FL"
};

// Run the Actor and wait for it to finish
const run = await client.actor("agentx/homes-property-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 = {
    "max_results": 10,
    "country": "United States",
    "location": "Miami, FL",
}

# Run the Actor and wait for it to finish
run = client.actor("agentx/homes-property-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 '{
  "max_results": 10,
  "country": "United States",
  "location": "Miami, FL"
}' |
apify call agentx/homes-property-scraper --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/acts/RRHhhMhNMDVcPxuml/builds/Ybb2YJAKDbUYAdgVy/openapi.json