# Homefinder Parser Script (`hello.datawizards/homefinder-parser-script`) Actor

The Homefinder Parser Script extracts rich, structured real-estate data from Homefinder listings, including price, address, property details, images, and agent info. Ideal for analytics, market research, automation, and investment insights with reliable residential proxy support.

- **URL**: https://apify.com/hello.datawizards/homefinder-parser-script.md
- **Developed by:** [datawizards](https://apify.com/hello.datawizards) (community)
- **Categories:** Automation, Lead generation, Real estate
- **Stats:** 3 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $8.00 / 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.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#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

***

## 🏡 Homefinder Parser Script · Apify Actor

Extract **high-quality real estate data** from Homefinder property listings with clean, structured JSON — ideal for real estate analytics, market research, investment insights, and automated property intelligence workflows.
Built and maintained by **[DataWizards](https://linkedin.com/in/data-wizards-aa8080342)**.

***

### 📌 What Is `Homefinder Parser Script`?

The **Homefinder Parser Script** is an advanced Apify Actor that **scrapes detailed property information** from Homefinder URLs.
It automates the extraction of real estate metadata such as price, size, location, agent details, coordinates, images, and more — without manual browsing.

If you work in **real estate analytics**, **proptech**, **lead generation**, **investment scouting**, or **market intelligence**, this tool is built for you.

***

### 🧠 Key Features

#### ✅ **Accurate Real-Estate Structured Data**

Extracts all major property details:

- Property type
- Full address
- Price & currency
- Bedrooms, bathrooms, square footage
- Coordinates (lat/long)
- Seller/agent
- Listing description & title
- Listing URLs and images
- Availability and posting dates

#### ✅ **SEO-Friendly, Clean JSON Output**

#### ✅ **Supports Residential Proxy for Stability**

Avoid blocking with

```json
"apifyProxyGroups": ["RESIDENTIAL"]
```

#### ✅ **Fast, scalable & easy to integrate**

Perfect for large datasets, analytics pipelines, dashboards, and automated workflows.

***

### 🛠️ Input Schema

```json
{
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"]
  }
}
```

#### 🔐 Proxy Configuration

- **useApifyProxy**: Must be `true`
- **apifyProxyGroups**: `"RESIDENTIAL"` recommended
- Ensures stable scraping without blocks

***

### 📤 Sample Output

```json
[
  {
    "propertyType": "SingleFamilyResidence",
    "streetAddress": "4102 Gage Xing",
    "city": "San Antonio",
    "state": "TX",
    "postalCode": "78253",
    "latitude": 29.476428,
    "longitude": -98.760421,
    "squareFeet": 4533,
    "bedrooms": 5,
    "description": "4102 Gage Xing, San Antonio, TX 78253 is for sale. View 51 photos...",
    "image": "https://ap.rdcpix.com/....jpg",
    "url": "https://homefinder.com/realestateandhomes-detail/...",
    "listingTitle": "4102 Gage Xing, San Antonio, TX 78253",
    "listingDescription": "...",
    "price": 699000,
    "currency": "USD",
    "availability": "https://schema.org/InStock",
    "seller": "eXp Realty, LLC",
    "offerUrl": "https://homefinder.com/...",
    "datePosted": "2025-11-19T23:02:39Z",
    "lastReviewed": "2025-12-02T00:58:51Z",
    "thumbnailUrl": "https://ap.rdcpix.com/....jpg",
    "primaryImage": "https://ap.rdcpix.com/....jpg"
  }
]
```

***

### 🚀 Use Cases

#### 🏢 Real Estate Market Intelligence

Track property prices, availability, and trends.

#### 📈 Investment & Portfolio Analysis

Identify undervalued listings, evaluate markets, and automate ROI models.

#### 🤖 PropTech Automations

Feed scraped property data directly into platforms, CRMs, or dashboards.

#### 📊 Competitive Research

Monitor listing updates, agents, and pricing changes.

#### 🏷️ Lead Generation

Build enriched datasets for buyer/seller outreach.

***

### ✅ Best Practices

- Use **RESIDENTIAL proxies** for high success rates.
- Avoid overloading Homefinder with excessive requests.
- Always validate the scraped URLs before execution.
- For large-scale projects, schedule runs via Apify’s cron settings.
- Export data via API for downstream analytics workflows.

***

### 💡 Additional Notes

If you want **custom fields**, simplified outputs, additional filtering, or complex automations —
**DataWizards is always ready to upgrade or customize your actor.**

***

### 🤝 Support

Need help, customization, or found a bug?

📩 **Email:** <hello.datawizard@gmail.com>
✉️ **Subject:** `Homefinder Parser Script – Support Request`

🔗 **Connect:**
<https://linkedin.com/in/data-wizards-aa8080342>

Your feedback helps us improve — thank you!

***

### 🧰 Custom Work & Enhancements

Whether you need:

- Bulk scraping
- Custom JSON formatting
- API integration
- Advanced domain-specific extraction
- Full automation pipelines

**DataWizards delivers fast, scalable, and tailored solutions.**

***

### 💬 Feedback & Bug Reporting

📧 Email: `hello.datawizard@gmail.com`
✉️ Use Subject: `Bug Report – Homefinder Parser Script`

We’ll get back to you quickly.
Thank you for choosing **DataWizards** ❤️
-----------------------------------------

# Actor input Schema

## `Urls` (type: `array`):

The urls for the spider.

## `proxyConfiguration` (type: `object`):

Specifies proxy servers that will be used by the scraper in order to hide its origin.

## Actor input object example

```json
{
  "Urls": [
    "https://homefinder.com/realestateandhomes-detail/4102-Gage-Xing_San-Antonio_TX_78253_M82172-01894?from=similar_homes_bm"
  ],
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

# 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 = {
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ]
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("hello.datawizards/homefinder-parser-script").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 = { "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
    } }

# Run the Actor and wait for it to finish
run = client.actor("hello.datawizards/homefinder-parser-script").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 '{
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}' |
apify call hello.datawizards/homefinder-parser-script --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,hello.datawizards/homefinder-parser-script"
        }
    }
}

```

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/VrNghvrBCdzTVzr0z/builds/GdlKNzImh9jdeJmJG/openapi.json