Realtor Properties Search Scraper

Scrapes residential property listings from Realtor Canada using a secure API wrapper. It searches by geographic area and supports extensive filtering, sorting, and pagination.

Key Features

• Area-based Search: Define a search area using latitude and longitude boundaries.
• Advanced Filtering: Filter by price, bedrooms, bathrooms, property type, transaction type (sale/rent), and more.
• Flexible Sorting: Sort results by price, listing date, virtual tours, open houses, or number of photos.
• Automatic Pagination: Efficiently fetches multiple pages, handling up to 50,000 results.
• Structured Output: Returns detailed, consistent data for each property.

How to Use

Configure the actor with your search parameters (see Input section) and run it. The actor will query the Realtor Canada API, handle pagination, and output each property as a separate item to the dataset.

Input

Provide input via the actor's configuration or as a JSON object.

Required Parameters

• LatitudeMax: Maximum latitude for the search bounding box.
• LatitudeMin: Minimum latitude.
• LongitudeMax: Maximum longitude.
• LongitudeMin: Minimum longitude.

Key Optional Parameters

• PriceMin / PriceMax: Filter by price range.
• BedRange / BathRange: Filter by bedroom/bathroom count (e.g., "1-3").
• TransactionTypeId: 2 for Sale, 3 for Rent.
• SortBy: Sort field (1=Price, 6=Date, 11=Virtual Tours, 12=Open Houses, 13=Photos).
• SortOrder: A for Ascending, D for Descending.
• maxResults: Total properties to fetch (default: 50, max: 50000).
• NumberOfDays: Listings posted within the last X days.
• Keywords: Comma-separated search terms.
• OpenHouse: Enable open house filter.

Output

Each property is output as a JSON object. Key fields include:

{
  "Id": "12345",
  "MlsNumber": "E1234567",
  "PublicRemarks": "Description...",
  "Property": {
    "Price": "$750,000",
    "PriceUnformattedValue": "750000",
    "Type": "Single Family",
    "Address": {
      "AddressText": "123 Main St, Toronto, ON",
      "Longitude": "-79.3832",
      "Latitude": "43.6532"
    },
    "Photo": [ ... ]
  },
  "Building": { "StoriesTotal": "2" },
  "Land": { "SizeTotal": "5000 sq ft" },
  "Individual": [ { "Name": "John Smith", "Position": "Agent" } ]
}