Redfin Property Search Scraper This actor searches for real estate properties on Redfin using our API wrapper service to find property listings based on various criteria. ## Features - Comprehensive Property Search: Search properties by location, price, features, and more - Advanced Filtering: Filter by price range, bedrooms, bathrooms, square footage, and property type - Multiple Sorting Options: Sort results by price, newest, square footage, lot size, and more - Real-time Results: Get instant property listings from Redfin - API Integration: Uses our secure API wrapper service - Error Handling: Comprehensive error handling and logging - Automatic Pagination: Automatically fetches multiple pages with maximum efficiency ## Input The actor accepts the following input parameters: ### Required Parameters - location: Location to search for properties (address or zip code) ### Optional Parameters - sub_location: Sub-location within the main location - search_by: Search type (places, schools, agents, buildings, addresses) - sort: Sort order (Recommended, Newest, PriceLowToHigh, PriceHighToLow, SquareFeet, LotSize, PriceSqft) - search_type: Search type (Sold, ForSale) - sold_within: Time range for sold properties (Last-1Week, Last-1Month, Last-3Months, Last-6Months, Last-1Year, Last-2Years, Last-3Years, Last-5Years) - min_price: Minimum price - max_price: Maximum price - home_type: Property type (comma-separated) - min_bedroom: Minimum number of bedrooms - max_bedroom: Maximum number of bedrooms - min_bathroom: Minimum number of bathrooms - status: Property status (ComingSoon, Active) - time_on_redfin: Time on Redfin (NewListings, LessThan3Days, LessThan7Days, LessThan14Days, LessThan30Days, MoreThan7Days, MoreThan14Days, MoreThan30Days, MoreThan45Days, MoreThan60Days, MoreThan90Days, MoreThan180Days) - min_square_feet: Minimum square footage - max_square_feet: Maximum square footage - min_lot_size: Minimum lot size - max_lot_size: Maximum lot size - min_stories: Minimum number of stories - max_stories: Maximum number of stories - min_year_built: Minimum year built - max_year_built: Maximum year built - garage_spots: Number of garage spots (1-5) - pool_type: Pool type (PrivatePool, CommunityPool, PrivateOrCommunityPool, NoPrivatePool) - keyword_search: Keyword search - listing_type: Listing type (comma-separated) - maxResults: Maximum number of properties to fetch (default: 15, max: 50000) ## Output The actor outputs each property as an individual data item. Each property contains: json { "propertyId": 12345, "listingId": 67890, "price": { "level": 1, "value": 750000 }, "beds": 3, "baths": 2, "sqFt": { "level": 1, "value": 2000 }, "lotSize": { "level": 1, "value": 5000 }, "yearBuilt": { "level": 1, "value": 1995 }, "stories": 2, "location": { "level": 1, "value": "123 Main St, San Francisco, CA 94102" }, "streetLine": { "level": 1, "value": "123 Main St" }, "city": "San Francisco", "state": "CA", "zip": "94102", "postalCode": { "level": 1, "value": "94102" }, "latLong": { "level": 1, "value": { "latitude": 37.7749, "longitude": -122.4194 } }, "listingRemarks": "Beautiful family home in prime location", "listingType": 1, "mlsStatus": "Active", "mlsId": { "label": "MLS#", "value": "1234567" }, "listingAgent": { "name": "John Smith", "redfinAgentId": 12345 }, "photos": { "items": [ "https://example.com/photo1.jpg", "https://example.com/photo2.jpg" ], "level": 1, "value": "https://example.com/photo1.jpg" }, "url": "https://www.redfin.com/property/12345", "scanUrl": "https://www.redfin.com/scan/12345", "dom": { "level": 1, "value": 15 }, "timeOnRedfin": { "date": 1640995200000, "level": 1, "value": 15 }, "openHouseStart": 1640995200000, "openHouseEnd": 1640998800000, "openHouseStartFormatted": "2022-01-01T10:00:00Z", "openHouseEventName": "Open House", "openHouseText": "Open House Sunday 10AM-1PM", "sashes": [ { "isActiveKeyListing": true, "isRedfin": false, "lastSaleDate": "2020-01-01", "lastSalePrice": "$650,000", "sashType": 1, "sashTypeColor": "#FF0000", "sashTypeId": 1, "sashTypeName": "Active" } ], "keyFacts": [ { "description": "3 beds, 2 baths", "rank": 1 } ], "pricePerSqFt": { "level": 1, "value": 375 }, "hoa": { "level": 1, "value": 0 }, "isHoaFrequencyKnown": false, "isHot": false, "isNewConstruction": false, "isRedfin": false, "isShortlisted": false, "isViewedListing": false, "has3DTour": true, "hasInsight": true, "hasVideoTour": true, "hasVirtualTour": true, "hideSalePrice": false, "showAddressOnMap": true, "showDatasourceLogo": true, "showMlsId": true, "soldDate": null, "partialBaths": 0, "fullBaths": 2, "propertyType": 1, "uiPropertyType": 1, "businessMarketId": 1, "marketId": 1, "dataSourceId": 1, "countryCode": "US", "timeZone": "America/Los_Angeles", "remarksAccessLevel": 1, "primaryPhotoDisplayLevel": 1, "searchStatus": 1, "unitNumber": { "level": 1 }, "additionalPhotosInfo": [], "alternatePhotosInfo": { "groupCode": "main", "mediaListIndex": 0, "mediaListType": "photo", "positionSpec": [0, 0], "type": 1 }, "newConstructionCommunityInfo": null, "originalTimeOnRedfin": { "date": 1640995200000, "level": 1, "value": 15 }, "posterFrameUrl": "https://example.com/poster.jpg", "scrapedAt": "2025-01-14T10:30:00.000Z" } ## Usage 1. Input Configuration: Provide location and search criteria 2. Set Max Results: Specify how many properties you want to fetch (up to 50000) 3. Run the Actor: Execute the actor with your input 4. Get Results: Receive individual property listings in the dataset ## Examples ### Basic Search by Location json { "location": "San Francisco, CA", "maxResults": 100 } ### Search with Price Filter json { "location": "San Francisco, CA", "min_price": 500000, "max_price": 1000000, "sort": "PriceLowToHigh", "maxResults": 50 } ### Search with Property Features json { "location": "San Francisco, CA", "min_bedroom": 2, "max_bedroom": 4, "min_bathroom": 2, "min_square_feet": 1500, "home_type": "Single Family", "maxResults": 75 } ### Search for Sold Properties json { "location": "San Francisco, CA", "search_type": "Sold", "sold_within": "Last-1Year", "sort": "Newest", "maxResults": 25 } ## Property Data Structure Each property listing includes: ### Basic Information - propertyId: Unique property identifier - listingId: MLS listing ID - price: Property price with level information - beds/baths: Number of bedrooms and bathrooms - sqFt: Square footage with level information - lotSize: Lot size with level information ### Location Information - location: Full address - streetLine: Street address - city/state/zip: City, state, and zip code - latLong: Latitude and longitude coordinates - postalCode: Postal code ### Property Details - yearBuilt: Year the property was built - stories: Number of stories - listingRemarks: Property description - listingType: Type of listing - mlsStatus: MLS status - mlsId: MLS identification ### Agent Information - listingAgent: Listing agent details - name: Agent name - redfinAgentId: Redfin agent ID ### Media and Photos - photos: Property photos - items: Array of photo URLs - level: Display level - value: Primary photo URL - url: Redfin property page URL - scanUrl: Redfin scan page URL ### Market Information - dom: Days on market - timeOnRedfin: Time on Redfin platform - openHouseStart/End: Open house times - openHouseText: Open house description ### Property Features - keyFacts: Key property facts - pricePerSqFt: Price per square foot - hoa: HOA fees - has3DTour/hasVideoTour/hasVirtualTour: Tour availability - isHot/isNewConstruction: Property status flags ### Listing Information - sashes: Listing badges and information - status: Property status (ComingSoon, Active) ## Search Parameters ### Sort Options - Recommended: Redfin's recommended order - Newest: Newest listings first - PriceLowToHigh/PriceHighToLow: Price sorting - SquareFeet: Square footage sorting - LotSize: Lot size sorting - PriceSqft: Price per square foot sorting ### Filter Options - search_type: Sold or ForSale properties - sold_within: Time range for sold properties - min_price/max_price: Price range filtering - min_bedroom/max_bedroom: Bedroom range - min_bathroom: Minimum bathrooms - min_square_feet/max_square_feet: Square footage range - home_type: Property type filtering - status: Property status filtering ### Location Search - location: Primary search location (required) - sub_location: Sub-location within main area - search_by: Search method (places, schools, agents, etc.) ## Use Cases ### Home Buying - Find properties in target neighborhoods - Compare prices and features - Track market trends ### Investment Analysis - Research sold properties for market analysis - Identify investment opportunities - Analyze price trends ### Market Research - Study property types and features - Analyze days on market - Research agent performance ### Property Monitoring - Track new listings - Monitor price changes - Follow open house schedules ## Support For technical support or questions about this actor, please contact our support team.