Realtor Properties Search Scraper

This actor searches for residential properties on Realtor Canada using our API wrapper service to find real estate listings based on various criteria.

Features

• Comprehensive Property Search: Search properties by geographic coordinates and various filters
• Advanced Filtering: Filter by price, bedrooms, bathrooms, property type, and more
• Multiple Sorting Options: Sort results by price, date, virtual tours, open houses, and photos
• Real-time Results: Get instant property listings from Realtor Canada
• API Integration: Uses our secure API wrapper service
• Error Handling: Comprehensive error handling and logging
• Automatic Pagination: Automatically fetches multiple pages with maximum efficiency (50 records per page)

Input

The actor accepts the following input parameters:

Required Parameters

• LatitudeMax: Maximum latitude coordinate for search area
• LatitudeMin: Minimum latitude coordinate for search area
• LongitudeMax: Maximum longitude coordinate for search area
• LongitudeMin: Minimum longitude coordinate for search area

Optional Parameters

• SortOrder: Sort order (A-ascending, D-descending)
• SortBy: Sort field (1-price, 6-date, 11-virtual tours, 12-open houses, 13-more photos)
• CultureId: Culture ID (1-English, 2-French, default: 1)
• NumberOfDays: Number of days on market
• Keywords: Search keywords (comma-separated)
• BedRange: Bedroom range (e.g., "1-3")
• BathRange: Bathroom range (e.g., "1-2")
• LandSizeRange: Land size range
• BuildingSizeRange: Building size range
• UnitRange: Unit range
• OpenHouseStartDate: Open house start date (MM/dd/yyyy format)
• OpenHouseEndDate: Open house end date (MM/dd/yyyy format)
• OpenHouse: Enable open house filter
• FarmTypeId: Farm type ID
• PriceMin: Minimum price
• PriceMax: Maximum price
• RentMin: Minimum rent
• RentMax: Maximum rent
• BuildingTypeId: Building type ID
• ZoningTypeGroupId: Zoning type group ID
• TransactionTypeId: Transaction type ID (2-sale, 3-rent)
• ConstructionStyleId: Construction style ID
• PropertySearchTypeId: Property search type ID
• ParkingTypeId: Parking type ID
• maxResults: Maximum number of properties to fetch (default: 50, max: 50000)

Output

The actor outputs each property as an individual data item. Each property contains:

{
    "Id": "12345",
    "MlsNumber": "E1234567",
    "PublicRemarks": "Beautiful family home in prime location",
    "PostalCode": "M5V 3A8",
    "ProvinceName": "Ontario",
    "StatusId": "1",
    "Distance": "0.5",
    "RelativeDetailsURL": "/property/12345",
    "RelativeURLEn": "/en/property/12345",
    "RelativeURLFr": "/fr/property/12345",
    "InsertedDateUTC": "2024-01-01T00:00:00Z",
    "TimeOnRealtor": "5 days",
    "HistoricalDataIsCleared": false,
    "PhotoChangeDateUTC": "2024-01-01T00:00:00Z",
    "UploadedBy": 123,
    "Building": {
        "StoriesTotal": "2"
    },
    "Property": {
        "Price": "$750,000",
        "Type": "Single Family",
        "TypeId": "1",
        "PriceUnformattedValue": "750000",
        "ShortValue": "$750K",
        "PriceChangeTimeOnRealtor": "2024-01-01T00:00:00Z",
        "PriceChangeTagDateUTC": "2024-01-01T00:00:00Z",
        "Address": {
            "AddressText": "123 Main St, Toronto, ON",
            "Longitude": "-79.3832",
            "Latitude": "43.6532",
            "PermitShowAddress": true
        },
        "Photo": [
            {
                "SequenceId": "1",
                "HighResPath": "https://example.com/high.jpg",
                "MedResPath": "https://example.com/med.jpg",
                "LowResPath": "https://example.com/low.jpg",
                "LastUpdated": "2024-01-01T00:00:00Z",
                "TypeId": "1"
            }
        ]
    },
    "Land": {
        "SizeTotal": "5000 sq ft"
    },
    "AlternateURL": {
        "VideoLink": "https://example.com/video"
    },
    "Media": [
        {
            "MediaCategoryId": "1",
            "MediaCategoryURL": "https://example.com/media",
            "Description": "Virtual Tour",
            "Order": 1,
            "VideoType": "virtual"
        }
    ],
    "Individual": [
        {
            "IndividualID": 67890,
            "Name": "John Smith",
            "FirstName": "John",
            "LastName": "Smith",
            "Position": "Real Estate Agent",
            "Photo": "https://example.com/agent.jpg",
            "PhotoHighRes": "https://example.com/agent-high.jpg",
            "CccMember": false,
            "HasListings": true,
            "PermitShowListingLink": true,
            "PermitFreetextEmail": true,
            "RelativeDetailsURL": "/agent/john-smith",
            "AgentPhotoLastUpdated": "2024-01-01T00:00:00Z",
            "RankMyAgentKey": "abc123",
            "RealSatisfiedKey": "def456",
            "TestimonialTreeKey": "ghi789",
            "CorporationDisplayTypeId": "1",
            "HasOrganizationListings": true,
            "Organization": {
                "OrganizationID": 12345,
                "Name": "ABC Real Estate",
                "OrganizationType": "Real Estate Brokerage",
                "Designation": "Licensed",
                "HasListings": true,
                "PermitFreetextEmail": true,
                "PermitShowListingLink": true,
                "RelativeDetailsURL": "/brokerage/abc-real-estate",
                "PhotoLastupdate": "2024-01-01T00:00:00Z",
                "Address": {
                    "AddressText": "456 Broker St, Toronto, ON",
                    "PermitShowAddress": true
                },
                "Phones": [
                    {
                        "PhoneType": "Office",
                        "PhoneNumber": "416-555-0123",
                        "AreaCode": "416",
                        "PhoneTypeId": "1"
                    }
                ]
            },
            "Phones": [
                {
                    "PhoneType": "Mobile",
                    "PhoneNumber": "416-555-0123",
                    "AreaCode": "416",
                    "PhoneTypeId": "2"
                }
            ],
            "Websites": [
                {
                    "Website": "https://johnsmith.com",
                    "WebsiteTypeId": "1"
                }
            ],
            "Emails": [
                {
                    "ContactId": "contact123"
                }
            ]
        }
    ],
    "Tags": [],
    "scrapedAt": "2025-01-14T10:30:00.000Z"
}

Usage

1. Input Configuration: Provide geographic coordinates 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 Coordinates

{
  "LatitudeMax": 43.6532,
  "LatitudeMin": 43.6000,
  "LongitudeMax": -79.3832,
  "LongitudeMin": -79.4000,
  "maxResults": 100
}

Search with Price Filter

{
  "LatitudeMax": 43.6532,
  "LatitudeMin": 43.6000,
  "LongitudeMax": -79.3832,
  "LongitudeMin": -79.4000,
  "PriceMin": 500000,
  "PriceMax": 1000000,
  "SortBy": "1",
  "SortOrder": "A",
  "maxResults": 50
}

Search with Property Features

{
  "LatitudeMax": 43.6532,
  "LatitudeMin": 43.6000,
  "LongitudeMax": -79.3832,
  "LongitudeMin": -79.4000,
  "BedRange": "2-4",
  "BathRange": "1-3",
  "TransactionTypeId": 2,
  "BuildingTypeId": 1,
  "maxResults": 75
}

Search with Keywords

{
  "LatitudeMax": 43.6532,
  "LatitudeMin": 43.6000,
  "LongitudeMax": -79.3832,
  "LongitudeMin": -79.4000,
  "Keywords": "downtown,condo,modern",
  "NumberOfDays": 30,
  "maxResults": 25
}

Property Data Structure

Each property listing includes:

Basic Information

• Id: Unique property identifier
• MlsNumber: MLS listing number
• PublicRemarks: Public description of the property
• PostalCode: Property postal code
• ProvinceName: Province name
• StatusId: Property status ID

Property Details

• Property: Detailed property information
  • Price: Formatted price display
  • Type: Property type
  • Address: Property address with coordinates
  • Photo: Array of property photos
  • PriceUnformattedValue: Raw price value
  • ShortValue: Short price format

Building and Land Information

• Building: Building details (stories, etc.)
• Land: Land size and details
• AlternateURL: Additional URLs (video tours, etc.)

Agent Information

• Individual: Array of listing agents with contact details
  • Organization: Agent's brokerage information
  • Phones: Agent contact numbers
  • Websites: Agent websites
  • Emails: Agent email contacts

Media and Additional Information

• Media: Virtual tours and media content
• Tags: Property tags
• Distance: Distance from search center
• TimeOnRealtor: Days on market

Search Parameters

Sort Options

• SortBy: 1 (Price), 6 (Date), 11 (Virtual Tours), 12 (Open Houses), 13 (More Photos)
• SortOrder: A (Ascending), D (Descending)

Filter Options

• TransactionTypeId: 2 (Sale), 3 (Rent)
• BuildingTypeId: Various building types
• PriceMin/PriceMax: Price range filtering
• BedRange/BathRange: Bedroom and bathroom ranges
• NumberOfDays: Days on market filter

Geographic Search

• LatitudeMax/Min: North/south boundary
• LongitudeMax/Min: East/west boundary

Support

For technical support or questions about this actor, please contact our support team.