NewHomeSource.com New Homes Scraper

All-in-one scraper for NewHomeSource.com — the US new-construction site covering new homes, floor plans, builders and communities. Pick a US state (optionally a city), or paste specific community / home links, and get one flat row per new home — home specs, price, address, geo coordinates, community context, builder and phone in a single JSON / CSV row.

What you get

• Every new home / floor plan across a state. Pick Texas once and the actor walks the state's market areas, every community in each, and every new home / floor plan inside — all in one run.
• Community + builder context on every row. Each row carries the home's own price, size, beds, baths, stories and garage count, plus the community's price band, floor-plan count, QMI (quick move-in) count, address and description, and the builder / brand name, ID and phone.
• Geo-ready. Latitude and longitude on every row, plus street address, city, county, state, zip.
• JSON or CSV out. No glue code — connect to your warehouse, BI tool or spreadsheet in one step.

How to use

1. Search mode — pick a state (and optional city)

Choose a state, optionally narrow to one city:

Field	What it does
State	The state to walk (market areas → communities → homes).
City	Optional. Narrow the search to a single city inside the state.

2. URL mode — paste specific links

Paste one or more NewHomeSource links. Accepted kinds:

• Community URLs — https://www.newhomesource.com/community/{state}/{city}/{slug}/{id} or https://www.newhomesource.com/basiccommunity/community-{id}/... — each expands to every home / floor plan in that community.
• Home URLs — https://www.newhomesource.com/plan/..., /specdetail/... or /basichome/... — each produces one row for that home / plan.

3. Filters (apply to both modes)

These narrow the results whichever mode you run, Search mode or a pasted community / home URL:

Field	What it does
Home types	Floor plans, QMI / spec homes, or both.
Minimum / maximum price	USD price bounds.
Minimum bedrooms / bathrooms	Room-count bounds.
Minimum / maximum size	Square-foot bounds.

4. Detail enrichment (optional)

Turn on Fetch full home details to add, per home: the full specification (all room areas, options, fees, rates, utilities, amenities), the complete photo gallery, videos and virtual tours, the builder and brand objects, the sales-office address / email / phone, school districts and schools, and the community's marketing copy. Each home enriched and returned is billed a small detail-enrichment surcharge on top of the result price.

5. Resume & recurring updates

• Resume from a previous run — continue one interrupted run without re-collecting or re-charging homes already returned there.
• Incremental changes for scheduled runs — run this same search daily / weekly and get only the changes: the first run returns everything as NEW; later runs return NEW, UPDATED and REAPPEARED homes by default. Optionally emit UNCHANGED or EXPIRED rows too (each returned row is billed). State is kept per search setup, or use a State key to name / share a monitoring campaign.

Output fields (one row per home)

Group	Fields
Home specs	homeId, planId, specId, listingId, listingNumber, floorPlan, bedrooms, bathrooms, halfBathrooms, garageCount, stories, homeSizeSqft, homePrice, moveInDate, dateFirstPublished, status, homeType, isSpec, specNumber, isHotHome, isLuxury, masterBedroomLocation, numLivingAreas
Community context	communityId, communityName, communityStatus, communityType, projectType, communityAddress, communityMinHomePrice, communityMaxHomePrice, communityMinHomeSize, communityMaxHomeSize, totalFloorPlans, qmiCount, secondaryCount, totalHomes, notes
Location	latitude, longitude, address, city, county, state, zip
Builder / brand	builderId, builderName, builderUrl, brandId, brandLogo, brandSiteUrl, phone
Source URLs	imageUrl, imageUrl2, communityUrl, homeUrl
Detail enrichment (optional)	description, marketingDescription, lotSqft, planTypeId, images, imagesCount, videos, tourUrl, planViewerUrl, selfGuidedTour, salesOfficeAddress, salesOfficeEmail, salesOfficePhone, schoolDistricts, schools, agents, homeOptions, feesAndRates, utilities, amenities, customAmenities, planAmenities, communityImages, communityImagesCount, communityVideos, communityHours, communityDirections, communitySalesOfficeEmail, communitySchoolDistricts, communitySchools, communityAgents, communityMapUrl
Incremental mode	changeType, changedFields, firstSeenAt, lastSeenAt

Send results into your apps (MCP connectors)

Optionally pipe results into the tools you already use via Model Context Protocol (MCP) connectors (Notion, Linear, Airtable, Apify). Authorize a connector once under Apify > Settings > Integrations, then select it in the input. The connector receives a condensed, human-readable summary per home (title + key fields), not the full JSON: the complete record always stays in the dataset, and this never changes the dataset output.

Field	What it does
mcpConnectors	MCP connectors to export results to (Notion, Linear, Airtable, Apify). Leave empty to skip.
notionParentPageUrl	Notion parent page URL (or id) under which item pages are created. Required for the Notion connector; ignored by others.
maxNotifyListings	Cap on items written to each connector per run (default 50). Does not affect the dataset.

Connection

Results are served only to US connections. Apify Proxy is used by default and works on every plan; leave it enabled (or supply your own US exit) for runs outside the US.

Limits

• Max items — the single cap on the run (default 20; 0 = unlimited). The run stops at this many home rows across all searches / URLs.
• Max pages per scope — optional per-scope page cap (0 = no limit; the walk stops at the natural end of results or at Max items).

FAQ

What is a QMI / spec home? A Quick Move-In home — already built or under construction and ready to close soon. Floor plans are the builder's catalog of plans you can order. The Home types toggle controls which appear.

Can I scrape multiple states? One state per run (plus optional city). To cover multiple states, schedule the actor with different State values, or paste community links from each state into one URL-mode run.

Do pasted single-home links include community context? Yes when Fetch full home details is on — the actor also reads the home's community record. With details off, a single home link returns the row with community rollup fields (price band, floor-plan count) left empty, because those live on the community page.