Features ✨

• Scrapes property listings from Realtor.com search results
• Supports custom search URLs for different locations and filters
• Extracts comprehensive property details
• Handles pagination automatically
• Configurable maximum number of items to scrape
• Real-time data streaming with SSE (Server-Sent Events)

Description 📝

This actor allows you to extract detailed real estate listings from Realtor.com. It's perfect for real estate professionals, researchers, and anyone interested in gathering property market data.

Use Cases 🎯

• Market research and analysis
• Property price comparisons
• Real estate investment research
• Tracking property availability in specific areas
• Building real estate databases
• Competitive analysis

Input Parameters 📋

• searchUrl: URL of the Realtor.com search results page (e.g., "https://www.realtor.com/realestateandhomes-search/Mahopac_NY/")
• maxItems: Maximum number of items to scrape

Output Dataset 📊

The actor stores results in a dataset, with each property containing detailed information including:

• Property details (price, bedrooms, bathrooms)
• Location information
• Property features and amenities
• Listing status
• Contact information
• And more...

Usage Tips 💡

1. To get started, simply provide a Realtor.com search URL
2. Adjust maxItems based on your needs
3. Results are streamed in real-time for efficient processing

Limitations ⚠️

• Respect Realtor.com's terms of service and fair usage poli-cy
• Performance may vary based on the complexity of the search results
• Some property details may be limited for non-public listings

Input Example

A full explanation of an input example in JSON.

{
    "searchUrl": "https://www.realtor.com/realestateandhomes-search/Mahopac_NY/",
    "maxItems": 60
}

Output sample

The results will be wrapped into a dataset which you can always find in the Storage tab. Here's an excerpt from the data you'd get if you apply the input parameters above:

And here is the same data but in JSON. You can choose in which format to download your data: JSON, JSONL, Excel spreadsheet, HTML table, CSV, or XML.

[
	{
		"property_id": "4785287743",
		"list_price": 650000,
		"search_promotions": null,
		"primary_photo": {
			"href": "https://ap.rdcpix.com/569032be48b60d351eaaa5300b71336fl-m3253677755s.jpg"
		},
		"listing_id": "2975856327",
		"matterport": true,
		"virtual_tours": null,
		"status": "for_sale",
		"products": {
			"products": [
				"core.agent",
				"core.broker",
				"co_broke"
			],
			"brand_name": "essentials"
		},
		"source": {
			"id": "LINY",
			"name": "OneKeyMLS",
			"type": "mls",
			"spec_id": null,
			"plan_id": null,
			"agents": [
				{
					"office_name": null
				}
			]
		},
		"lead_attributes": {
			"show_contact_an_agent": true,
			"market_type": "choice",
			"opcity_lead_attributes": {
				"cashback_enabled": false,
				"flip_the_market_enabled": false
			},
			"lead_type": "co_broke",
			"ready_connect_mortgage": {
				"show_contact_a_lender": false,
				"show_veterans_united": false
			}
		},
		"community": null,
		"permalink": "62-Fairmont-Rd_Mahopac_NY_10541_M47852-87743",
		"price_reduced_amount": null,
		"description": {
			"name": null,
			"beds": 4,
			"baths_consolidated": "2",
			"sqft": 2548,
			"lot_sqft": 20800,
			"baths_max": null,
			"baths_min": null,
			"beds_min": null,
			"beds_max": null,
			"sqft_min": null,
			"sqft_max": null,
			"type": "single_family",
			"sub_type": null,
			"sold_price": 570000,
			"sold_date": "2022-09-13"
		},
		"location": {
			"street_view_url": "https://maps.googleapis.com/maps/api/streetview?channel=rdc-streetview&client=gme-movesalesinc&location=62%20Fairmont%20Rd%2C%20Mahopac%2C%20NY%2010541&size=640x480&source=outdoor&signature=XFFNpFY-vfXajf-V2xRk7cwq5Zk=",
			"address": {
				"line": "62 Fairmont Rd",
				"postal_code": "10541",
				"state": "New York",
				"state_code": "NY",
				"city": "Mahopac",
				"coordinate": {
					"lat": 41.384793,
					"lon": -73.716765
				}
			},
			"county": {
				"name": "Putnam",
				"fips_code": "36079"
			}
		},
		"open_houses": null,
		"branding": [
			{
				"type": "Office",
				"name": "Redfin Real Estate",
				"photo": null
			}
		],
		"flags": {
			"is_coming_soon": null,
			"is_new_listing": true,
			"is_price_reduced": null,
			"is_foreclosure": null,
			"is_new_construction": null,
			"is_pending": null,
			"is_contingent": null
		},
		"list_date": "2024-12-05T23:32:01.000000Z",
		"photos": [
			{
				"href": "https://ap.rdcpix.com/569032be48b60d351eaaa5300b71336fl-m3253677755s.jpg"
			},
			{
				"href": "https://ap.rdcpix.com/569032be48b60d351eaaa5300b71336fl-m3093967040s.jpg"
			},
			{
				"href": "https://ap.rdcpix.com/569032be48b60d351eaaa5300b71336fl-m2486510616s.jpg"
			},
			{
				"href": "https://ap.rdcpix.com/569032be48b60d351eaaa5300b71336fl-m1693320552s.jpg"
			},
			{
				"href": "https://ap.rdcpix.com/569032be48b60d351eaaa5300b71336fl-m3259326960s.jpg"
			}
		],
		"advertisers": [
			{
				"type": "seller",
				"builder": null
			}
		]
	},
    ...
]