Realtor Agents Search Scraper

This actor searches for real estate agents on Realtor Canada using our API wrapper service to find property professionals based on various criteria.

Features

• Comprehensive Agent Search: Search agents by name, company, city, or province
• Advanced Filtering: Filter by specialties, designations, languages, and more
• Multiple Sorting Options: Sort results by name, city, province, or custom criteria
• Real-time Results: Get instant agent 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

At least one search parameter must be provided:

• FirstName: First name to search for
• LastName: Last name to search for
• CompanyName: Company name to search for
• City: City to search for agents

Optional Parameters

• SortOrder: Sort order (A-ascending, D-descending)
• SortBy: Sort field (11-no preference, 3-last name, 2-first name, 8-city, 9-province)
• CultureId: Culture ID (1-English, 2-French, default: 1)
• 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: Filter by Canadian Commercial Network membership
• maxResults: Maximum number of agents to fetch (default: 50, max: 1000)

Output

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

{
    "IndividualID": 12345,
    "Name": "John Smith",
    "FirstName": "John",
    "LastName": "Smith",
    "Position": "Real Estate Agent",
    "Photo": "https://example.com/photo.jpg",
    "PhotoHighRes": "https://example.com/photo-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",
    "Organization": {
        "OrganizationID": 67890,
        "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": "123 Main 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"
        }
    ],
    "scrapedAt": "2025-01-14T10:30:00.000Z"
}

Usage

1. Input Configuration: Provide search criteria and filtering options
2. Set Max Results: Specify how many agents you want to fetch (up to 1000)
3. Run the Actor: Execute the actor with your input
4. Get Results: Receive individual agent listings in the dataset

Examples

Search by Name

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

Search by Company

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

Search by City

{
  "City": "Toronto",
  "ProvinceIds": 35,
  "SortBy": 8,
  "maxResults": 75
}

Search with Specialties

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

Agent Data Structure

Each agent listing includes:

Basic Information

• IndividualID: Unique agent identifier
• Name: Full name of the agent
• FirstName: First name of the agent
• LastName: Last name of the agent
• Position: Agent's position/title
• Photo: Agent's photo URL
• PhotoHighRes: High-resolution photo URL

Contact Information

• Phones: Array of phone numbers with types
• Websites: Array of website URLs
• Emails: Array of email contact information

Organization Information

• Organization: Detailed organization/brokerage information
  • OrganizationID: Unique organization identifier
  • Name: Organization name
  • Address: Organization address
  • Phones: Organization phone numbers
  • OrganizationType: Type of organization
  • Designation: Organization designation

Status and Permissions

• CccMember: Canadian Commercial Network membership status
• HasListings: Whether agent has active listings
• PermitShowListingLink: Permission to show listing links
• PermitFreetextEmail: Permission for freetext email

URLs and Keys

• RelativeDetailsURL: Relative URL to agent details page
• RankMyAgentKey: Key for RankMyAgent integration
• RealSatisfiedKey: Key for RealSatisfied integration
• TestimonialTreeKey: Key for testimonial system

Search Parameters

Sort Options

• SortBy: 11 (No preference), 3 (Last name), 2 (First name), 8 (City), 9 (Province)
• SortOrder: A (Ascending), D (Descending)

Culture Options

• CultureId: 1 (English), 2 (French)

Filter Options

• ProvinceIds: Province ID for location filtering
• Languages: Language ID for language filtering
• Specialties: Specialty ID for expertise filtering
• Designations: Designation ID for certification filtering
• isCccMember: Boolean for Canadian Commercial Network membership

Support

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