# Newhomesource Property Details Scraper (`alexist/newhomesource-property-details-scraper`) Actor

Scrape detailed new construction property data from NewHomeSource.com. Collect pricing, builder info, amenities, market data, and 45+ fields per listing — perfect for real estate investors, market researchers, and developers analyzing new home communities.

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

## Pricing

Pay per usage

This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have.

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

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

## NewHomeSource Property Details Scraper: Extract Builder Community Data

***

### What Is NewHomeSource.com?

NewHomeSource.com is the leading digital platform for discovering and comparing new construction homes across the United States. It connects home buyers with builders, displays community information, pricing, floor plans, and market insights. Extracting this data manually is labor-intensive — the **NewHomeSource Property Details Scraper** automates collection, delivering structured property and builder data at scale.

***

### Overview

The **NewHomeSource Property Details Scraper** extracts comprehensive information from individual new home community pages on NewHomeSource.com. It captures everything from pricing and amenities to builder metadata and market positioning. Ideal for:

- **Real estate investors** tracking new construction inventory and pricing trends
- **Market researchers** analyzing builder activity and regional supply
- **Builders and agents** monitoring competitor communities and pricing strategies
- **BI analysts** building datasets for real estate market analytics
- **Data aggregators** feeding new construction listings into multi-source platforms

Key features include bulk URL import, error resilience via `ignore_url_failures`, and comprehensive output spanning 45+ fields across community, builder, pricing, and market dimensions.

***

### Input Format

The scraper accepts a JSON configuration object:

```json
{
    "urls": [
        "https://www.newhomesource.com/community/id/kuna/reveille-at-valor-by-tresidio-homes/202475",
        "https://www.newhomesource.com/community/id/kuna/medallion-at-valor-by-tresidio-homes/202479"
    ],
    "max_items_per_url": 200,
    "ignore_url_failures": true
}
```

| Field | Description |
|---|---|
| `urls` | Array of NewHomeSource community detail page URLs. Each URL points to a specific builder community (e.g., a subdivision in a city). Copy full URLs directly from your browser. |
| `max_items_per_url` | Maximum records to extract per URL. Default is 200. Set lower for faster testing runs. |
| `ignore_url_failures` | If `true`, scraper continues if some URLs fail. If `false`, the run stops at the first failure. Recommended: `true` for bulk runs. |

> **Tip:** Use bulk edit to paste 5–100 community URLs at once for efficient data collection campaigns.

***

### Output Format

**Sample output**

```json
{
  "page_type": "Community_Detail",
  "partner_name": "NewHomeSource",
  "brand_partner_name": "NewHomeSource",
  "partner_id": "1",
  "adaptive_template": "D",
  "user_country": "",
  "user_market_id": "000",
  "user_zip_code": "",
  "user_state": "",
  "user_city": "",
  "build_code_version": "8.3.9.0-RC2",
  "segment_anonymous_id": null,
  "market_id": "96",
  "market_name": "Boise, ID",
  "builder_id": "61349",
  "brand_id": "2",
  "is_coming_soon": "False",
  "was_matched_as_spotlight_result": "False",
  "is_comm_spotlight": "False",
  "result_position": "null",
  "community_id": "222710",
  "city": "Kuna",
  "price_range": [
    "p04",
    "p05",
    "p06"
  ],
  "county": "Ada",
  "builder_corp": "Toll Brothers",
  "brand_name": "Toll Brothers",
  "builder_division": "IDAHO",
  "community_name": "Tribute at Valor - Magnolia",
  "community_type": "Community",
  "project_type": "SBC",
  "amenities": "Green",
  "off_market": "False",
  "price_low": "489995.0000",
  "price_high": "694000.0000",
  "state": "IDAHO",
  "zip_code": "83634",
  "price_reduction": "Y",
  "is_automation": false,
  "trust_builder_reviews": "False",
  "location": "Kuna, Idaho",
  "is_limited_availability": "False",
  "is_priced": "True",
  "has_isp": "False",
  "has_ifp": "False",
  "i_uid": "{48a45946-1020-4f2c-b3e4-0140fd927e5f}",
  "user_status": "0"
}
```

Each community page returns a rich dataset with 45+ fields organized into six categories:

#### Page & Session Context

| Field | Meaning |
|---|---|
| `Page Type` | Type of page scraped (e.g., community detail page) |
| `Partner Name` | NewHomeSource partner or source label |
| `Brand Partner Name` | Partner brand name if applicable |
| `Partner ID` | Unique identifier for the partner account |
| `Segment Anonymous ID` | Anonymized tracking ID for user session |
| `Adaptive Template` | Template version used by the page |
| `Is Automation` | Boolean flag for automated listing |

#### User & Market Location Data

| Field | Meaning |
|---|---|
| `User Country` | Country of the user/search context |
| `User State` | State where the user searched |
| `User City` | City of user's search location |
| `User Market ID` | Market identifier for user's location |
| `User ZIP Code` | User's ZIP code for localization |
| `Market ID` | Unique ID for the property's market/region |
| `Market Name` | Display name of the market region |
| `Build Code Version` | Version identifier for the market's build code |

#### Community Identity & Classification

| Field | Meaning |
|---|---|
| `Community ID` | Unique Hosco/NewHomeSource ID for the community |
| `Community Name` | Display name of the community (e.g., "Reveille at Valor") |
| `Community Type` | Type of community (e.g., single-family, townhome) |
| `Project Type` | Project classification (e.g., master-planned community, subdivision) |
| `Is Coming Soon` | Boolean indicating if the community is not yet opened |
| `Is Limited Availability` | Boolean flag for low inventory status |
| `Off Market` | Boolean indicating off-market or private listing status |

#### Builder & Brand Information

| Field | Meaning |
|---|---|
| `Builder ID` | Unique identifier for the builder company |
| `Builder Corp` | Parent corporation of the builder |
| `Builder Division` | Specific division or brand within the builder |
| `Brand ID` | Unique ID for the brand under which homes are sold |
| `Brand Name` | Display name of the builder/brand (e.g., "Tresidio Homes") |

#### Geographic & Administrative Data

| Field | Meaning |
|---|---|
| `City` | City where the community is located |
| `County` | County of the property |
| `State` | State abbreviation (e.g., "ID") |
| `ZIP Code` | Postal code of the community |
| `Location` | Formatted full address or location string |

#### Pricing & Availability

| Field | Meaning |
|---|---|
| `Price Range` | Displayed price range as text (e.g., "$300K–$500K") |
| `Price Low` | Minimum home price in the community |
| `Price High` | Maximum home price in the community |
| `Is Priced` | Boolean indicating whether pricing is publicly listed |
| `Price Reduction` | Boolean flag if prices have been reduced |

#### Marketing & Spotlight Flags

| Field | Meaning |
|---|---|
| `Was Matched As Spotlight Result` | Boolean indicating prior spotlight placement |
| `Is Comm Spotlight` | Current spotlight/featured listing status |
| `Result Position` | Position in search results when originally captured |
| `Trust Builder Reviews` | Boolean for builder review trust flag |

#### Inventory & Services

| Field | Meaning |
|---|---|
| `Has ISP` | Boolean indicating if community has In-Stock Homes (ready-to-move) |
| `Has IFP` | Boolean indicating if custom floor plans are available |
| `Amenities` | Text or array of community amenities (pools, gyms, parks, etc.) |

#### User & Reporting

| Field | Meaning |
|---|---|
| `I UID` | Internal unique identifier for reporting purposes |
| `User Status` | User status or engagement level (e.g., lead, repeat visitor) |

***

### How to Use

1. **Identify URLs** — Visit NewHomeSource.com and search for communities. Click into individual community detail pages and copy the full URL from your browser address bar.

2. **Prepare your URL list** — Gather 5–100 community URLs. You can paste them one by one or use bulk edit:
   ```
   https://www.newhomesource.com/community/id/[city]/[community-slug]/[id]
   https://www.newhomesource.com/community/id/[city]/[community-slug]/[id]
   ```

3. **Configure settings** — Set `max_items_per_url` to `200` (or adjust for performance) and `ignore_url_failures` to `true` for robust batch runs.

4. **Start the run** — Launch the scraper. Monitor the run log to confirm successful extraction.

5. **Export & integrate** — Download results as JSON, CSV, or Excel. Import into your CRM, BI tool, or database.

**Troubleshooting:**

- **No data returned:** Verify the URL is a community detail page, not a search results page.
- **Partial fields:** Some communities may not fill all 45 fields if data is unavailable. This is normal.
- **Rate limiting:** For very large runs (1000+ URLs), space requests over time to avoid temporary IP blocks.

***

### Use Cases & Business Value

- **Competitive intelligence:** Track new builder activities, pricing changes, and market saturation by region
- **Real estate investment analysis:** Identify emerging communities, pricing trends, and builder market share
- **Lead generation:** Build targeted lists of communities matching specific criteria (price, location, builder)
- **Market research reports:** Aggregate regional data to identify trends in new construction supply and demand
- **Broker & agent tools:** Feed community data into internal MLS-like systems for client searches

The NewHomeSource Property Details Scraper eliminates weeks of manual research, enabling data-driven decisions on new home market dynamics.

***

### Conclusion

The **NewHomeSource Property Details Scraper** delivers fast, structured access to new construction community data across the United States. With 45+ fields capturing pricing, builder identity, market context, and amenities, it is the most efficient way to analyze new home trends at scale. Start scraping today and unlock competitive intelligence that drives smarter real estate strategies.

# Actor input Schema

## `urls` (type: `array`):

Add the URLs of the Specific property urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.

## `ignore_url_failures` (type: `boolean`):

If true, the scraper will continue running even if some URLs fail to be scraped.

## Actor input object example

```json
{
  "urls": [
    "https://www.newhomesource.com/community/id/kuna/reveille-at-valor-by-tresidio-homes/202475",
    "https://www.newhomesource.com/community/id/kuna/medallion-at-valor-by-tresidio-homes/202479",
    "https://www.newhomesource.com/community/id/kuna/bellaro-springs-by-hayden-homes-inc/216104",
    "https://www.newhomesource.com/community/id/kuna/tribute-at-valor-magnolia-by-toll-brothers/222710",
    "https://www.newhomesource.com/community/id/kuna/tribute-at-valor-arbor-by-toll-brothers/222712"
  ],
  "ignore_url_failures": true
}
```

# 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 = {
    "urls": [
        "https://www.newhomesource.com/community/id/kuna/reveille-at-valor-by-tresidio-homes/202475",
        "https://www.newhomesource.com/community/id/kuna/medallion-at-valor-by-tresidio-homes/202479",
        "https://www.newhomesource.com/community/id/kuna/bellaro-springs-by-hayden-homes-inc/216104",
        "https://www.newhomesource.com/community/id/kuna/tribute-at-valor-magnolia-by-toll-brothers/222710",
        "https://www.newhomesource.com/community/id/kuna/tribute-at-valor-arbor-by-toll-brothers/222712"
    ],
    "ignore_url_failures": true
};

// Run the Actor and wait for it to finish
const run = await client.actor("alexist/newhomesource-property-details-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 = {
    "urls": [
        "https://www.newhomesource.com/community/id/kuna/reveille-at-valor-by-tresidio-homes/202475",
        "https://www.newhomesource.com/community/id/kuna/medallion-at-valor-by-tresidio-homes/202479",
        "https://www.newhomesource.com/community/id/kuna/bellaro-springs-by-hayden-homes-inc/216104",
        "https://www.newhomesource.com/community/id/kuna/tribute-at-valor-magnolia-by-toll-brothers/222710",
        "https://www.newhomesource.com/community/id/kuna/tribute-at-valor-arbor-by-toll-brothers/222712",
    ],
    "ignore_url_failures": True,
}

# Run the Actor and wait for it to finish
run = client.actor("alexist/newhomesource-property-details-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 '{
  "urls": [
    "https://www.newhomesource.com/community/id/kuna/reveille-at-valor-by-tresidio-homes/202475",
    "https://www.newhomesource.com/community/id/kuna/medallion-at-valor-by-tresidio-homes/202479",
    "https://www.newhomesource.com/community/id/kuna/bellaro-springs-by-hayden-homes-inc/216104",
    "https://www.newhomesource.com/community/id/kuna/tribute-at-valor-magnolia-by-toll-brothers/222710",
    "https://www.newhomesource.com/community/id/kuna/tribute-at-valor-arbor-by-toll-brothers/222712"
  ],
  "ignore_url_failures": true
}' |
apify call alexist/newhomesource-property-details-scraper --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/swq912pZcktYeNjpy/builds/h9BBvVfGcubMQfLkL/openapi.json