Realtor Agents Search Scraper

Pricing

Rating

Developer

Actor stats

Categories

Share

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.