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:

{
    "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

{
  "location": "San Francisco, CA",
  "maxResults": 100
}

Search with Price Filter

{
  "location": "San Francisco, CA",
  "min_price": 500000,
  "max_price": 1000000,
  "sort": "PriceLowToHigh",
  "maxResults": 50
}

Search with Property Features

{
  "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

{
  "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.