Realtor Agents Search Scraper

Scrapes real estate agent listings from Realtor Canada using a secure API wrapper. Search by name, company, or location, then filter and sort the results.

Overview

This actor searches the Realtor Canada directory for property professionals. It returns structured agent profiles including contact details, company information, and professional designations. The actor handles pagination automatically, fetching up to 1000 records.

Key Features

• Flexible Search: Find agents by first name, last name, company name, city, or province.
• Advanced Filtering: Narrow results by specialties, professional designations, languages, and Canadian Commercial Network membership.
• Configurable Sorting: Sort results by name, city, province, or use no preference.
• Efficient Pagination: Automatically retrieves multiple pages (50 records per page).
• Structured Output: Returns consistent, detailed JSON objects for each agent.

Input

Configure the actor using input parameters. At least one search parameter is required.

Required Parameters (At least one)

• FirstName: Agent's first name.
• LastName: Agent's last name.
• CompanyName: Name of the brokerage/company.
• City: City to search within.

Optional Parameters

• SortOrder: "A" for ascending, "D" for descending.
• SortBy: Sort field: 11 (no preference), 3 (last name), 2 (first name), 8 (city), 9 (province).
• CultureId: 1 for English (default), 2 for French.
• ProvinceIds: Province ID to filter by.
• Languages: Language ID to filter by.
• Specialties: Specialty ID to filter by.
• Designations: Designation ID to filter by.
• isCccMember: true/false to filter by Canadian Commercial Network membership.
• maxResults: Maximum agents to fetch. Default is 50, maximum is 1000.

Output

The actor outputs each agent as a separate item in the dataset. The structure includes personal details, company information, and contact data.

{
  "IndividualID": 12345,
  "Name": "John Smith",
  "FirstName": "John",
  "LastName": "Smith",
  "Position": "Real Estate Agent",
  "Photo": "https://example.com/photo.jpg",
  "Organization": {
    "OrganizationID": 67890,
    "Name": "ABC Real Estate",
    "Address": {
      "AddressText": "123 Main St, Toronto, ON"
    },
    "Phones": [{"PhoneType": "Office", "PhoneNumber": "416-555-0123"}]
  },
  "Phones": [{"PhoneType": "Mobile", "PhoneNumber": "416-555-0123"}],
  "Websites": [{"Website": "https://johnsmith.com"}],
  "Emails": [{"ContactId": "contact123"}],
  "scrapedAt": "2025-01-14T10:30:00.000Z"
}

How to Use

1. Configure Input: Provide your search criteria (e.g., City: "Toronto") and any desired filters or sort options.
2. Set Limit: Define the maxResults parameter (default 50, max 1000).
3. Run Actor: Execute the actor with your configured input.
4. Retrieve Data: Access the structured agent listings from the actor's dataset.

Example Inputs

Search by Name:

{
  "FirstName": "John",
  "LastName": "Smith",
  "SortOrder": "A",
  "maxResults": 50
}

Search by Company:

{
  "CompanyName": "ABC Real Estate",
  "maxResults": 100
}

Search by City with Filters:

{
  "City": "Vancouver",
  "Specialties": 1,
  "Designations": 2,
  "isCccMember": true,
  "maxResults": 25
}