HomeFinder Real Estate Scraper

Scrape real estate listings from HomeFinder.com — homes for sale and homes for rent across the United States. Search by city + state or by ZIP code. Get price, beds/baths, square footage, lot size, year built, address and coordinates, photos, property type, agent/brokerage contact, and the listing detail URL. No login, no cookies, no proxy required.

What this actor does

• Two search modes: search (city + state) and byZip (5-digit ZIP code)
• For sale or for rent: every listing is scraped with its actual for_sale / for_rent status
• Property type filter: single family, condo, co-op, multi-family, townhome, mobile/manufactured, land, apartment
• Price, bedroom, bathroom, square footage, and lot size filters
• Sort order: best match, price low-to-high, price high-to-low, or newest listings first
• Reliable pagination: paginates using the site's own authoritative listing count, so results aren't silently truncated
• Empty fields are omitted — every record only contains fields with real data

Output per listing

• propertyId, listingId, status, transactionType, propertyType, propertyName
• listPrice (or listPriceMin/listPriceMax for rental unit ranges), priceReducedAmount
• beds / bedsMin / bedsMax, bathsConsolidated / bathsMin / bathsMax
• sqft / sqftMin / sqftMax, lotSqft, yearBuilt, garage
• soldPrice, soldDate (for previously-sold properties)
• address, city, state, stateCode, postalCode, county, latitude, longitude
• primaryPhotoUrl, photoUrls[] (up to 5), photoCount
• sourceName, sourceType, brokerageName, agentName, agentEmail, agentPhone
• isNewListing, isPriceReduced, isForeclosure, isNewConstruction, isPending, isContingent, isComingSoon, isAuction
• petsAllowedCats, petsAllowedDogs, hasSpecials, applicationUrl (rentals)
• hasMatterportTour, listDate, listingUrl
• recordType: "property", scrapedAt

Input

Field	Type	Default	Description
mode	select	search	search (city+state) or byZip
city	string	New York	City name (mode=search)
state	select	NY	2-letter US state code (mode=search)
zipCode	string	10001	5-digit ZIP code (mode=byZip)
transactionType	select	for_sale	for_sale or for_rent
propertyType	select	any	Property type filter
priceMin	int	–	Minimum listing price ($)
priceMax	int	–	Maximum listing price ($)
bedroomsMin	select	0 (any)	Minimum bedrooms
bathroomsMin	select	0 (any)	Minimum bathrooms
sqftMin	int	–	Minimum square footage
sqftMax	int	–	Maximum square footage
lotSqftMin	int	–	Minimum lot size in sq ft (for-sale listings only)
lotSqftMax	int	–	Maximum lot size in sq ft (for-sale listings only)
sortOrder	select	relevance	relevance, price_asc, price_desc, or newest
maxItems	int	30	Hard cap on emitted records (1–1000)

Example: homes for sale in New York, NY

{
  "mode": "search",
  "city": "New York",
  "state": "NY",
  "transactionType": "for_sale",
  "maxItems": 50
}

Example: rentals near a ZIP code, 2+ beds

{
  "mode": "byZip",
  "zipCode": "10001",
  "transactionType": "for_rent",
  "bedroomsMin": "2",
  "maxItems": 50
}

Example: condos for sale in a price band

{
  "mode": "search",
  "city": "Austin",
  "state": "TX",
  "transactionType": "for_sale",
  "propertyType": "condos",
  "priceMin": 200000,
  "priceMax": 500000,
  "maxItems": 100
}

Example: newest single-family homes, 1,500–2,500 sqft, on a 5,000+ sqft lot

{
  "mode": "search",
  "city": "Phoenix",
  "state": "AZ",
  "transactionType": "for_sale",
  "propertyType": "single_family",
  "sqftMin": 1500,
  "sqftMax": 2500,
  "lotSqftMin": 5000,
  "sortOrder": "newest",
  "maxItems": 50
}

Use cases

• Real estate market research — track pricing, inventory, and property mix by city or ZIP
• Relocation & lead gen — build a searchable database of homes/rentals for a target area
• Investment analysis — filter by price, beds, baths, and property type across markets
• PropTech data feeds — power listing search UIs with fresh, structured records
• Rental market tracking — compare rent ranges and amenities across neighborhoods

FAQ

Do I need a proxy or login? No. HomeFinder.com serves listing data via a public, server-rendered Next.js page with no authentication or anti-bot wall observed.

How does pagination work? Each search page embeds the site's own authoritative total listing count. The actor keeps fetching pages until it has covered that count, hit maxItems, or a page returns no new listings — it never silently stops early on a guessed page size.

Why do some rental listings show listPriceMin/listPriceMax instead of listPrice? Rental communities often list a price range across multiple unit types. When only a range is available, listPrice is filled in as the midpoint of the range for easy filtering/sorting, and the original range is preserved.

What if my city/state or ZIP returns 0 results? The actor sets a clear status message and finishes with an empty dataset rather than erroring — check the run's status message for details.

Does the lot size filter work for rentals? No — apartment/rental listings on HomeFinder.com don't carry lot size data, so lotSqftMin/lotSqftMax only take effect when transactionType is for_sale.

What states/ZIPs are supported? All 50 US states + DC, and any valid 5-digit US ZIP code.

How fresh is the data? Listings are served live from HomeFinder.com's search index at scrape time.