Realtor.com Scraper 🏠

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 policy
• 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.

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

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.

1[
2	{
3		"property_id": "4785287743",
4		"list_price": 650000,
5		"search_promotions": null,
6		"primary_photo": {
7			"href": "https://ap.rdcpix.com/569032be48b60d351eaaa5300b71336fl-m3253677755s.jpg"
8		},
9		"listing_id": "2975856327",
10		"matterport": true,
11		"virtual_tours": null,
12		"status": "for_sale",
13		"products": {
14			"products": [
15				"core.agent",
16				"core.broker",
17				"co_broke"
18			],
19			"brand_name": "essentials"
20		},
21		"source": {
22			"id": "LINY",
23			"name": "OneKeyMLS",
24			"type": "mls",
25			"spec_id": null,
26			"plan_id": null,
27			"agents": [
28				{
29					"office_name": null
30				}
31			]
32		},
33		"lead_attributes": {
34			"show_contact_an_agent": true,
35			"market_type": "choice",
36			"opcity_lead_attributes": {
37				"cashback_enabled": false,
38				"flip_the_market_enabled": false
39			},
40			"lead_type": "co_broke",
41			"ready_connect_mortgage": {
42				"show_contact_a_lender": false,
43				"show_veterans_united": false
44			}
45		},
46		"community": null,
47		"permalink": "62-Fairmont-Rd_Mahopac_NY_10541_M47852-87743",
48		"price_reduced_amount": null,
49		"description": {
50			"name": null,
51			"beds": 4,
52			"baths_consolidated": "2",
53			"sqft": 2548,
54			"lot_sqft": 20800,
55			"baths_max": null,
56			"baths_min": null,
57			"beds_min": null,
58			"beds_max": null,
59			"sqft_min": null,
60			"sqft_max": null,
61			"type": "single_family",
62			"sub_type": null,
63			"sold_price": 570000,
64			"sold_date": "2022-09-13"
65		},
66		"location": {
67			"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=",
68			"address": {
69				"line": "62 Fairmont Rd",
70				"postal_code": "10541",
71				"state": "New York",
72				"state_code": "NY",
73				"city": "Mahopac",
74				"coordinate": {
75					"lat": 41.384793,
76					"lon": -73.716765
77				}
78			},
79			"county": {
80				"name": "Putnam",
81				"fips_code": "36079"
82			}
83		},
84		"open_houses": null,
85		"branding": [
86			{
87				"type": "Office",
88				"name": "Redfin Real Estate",
89				"photo": null
90			}
91		],
92		"flags": {
93			"is_coming_soon": null,
94			"is_new_listing": true,
95			"is_price_reduced": null,
96			"is_foreclosure": null,
97			"is_new_construction": null,
98			"is_pending": null,
99			"is_contingent": null
100		},
101		"list_date": "2024-12-05T23:32:01.000000Z",
102		"photos": [
103			{
104				"href": "https://ap.rdcpix.com/569032be48b60d351eaaa5300b71336fl-m3253677755s.jpg"
105			},
106			{
107				"href": "https://ap.rdcpix.com/569032be48b60d351eaaa5300b71336fl-m3093967040s.jpg"
108			},
109			{
110				"href": "https://ap.rdcpix.com/569032be48b60d351eaaa5300b71336fl-m2486510616s.jpg"
111			},
112			{
113				"href": "https://ap.rdcpix.com/569032be48b60d351eaaa5300b71336fl-m1693320552s.jpg"
114			},
115			{
116				"href": "https://ap.rdcpix.com/569032be48b60d351eaaa5300b71336fl-m3259326960s.jpg"
117			}
118		],
119		"advertisers": [
120			{
121				"type": "seller",
122				"builder": null
123			}
124		]
125	},
126    ...
127]