Dubai Real Estate Agent Scraper

A high-performance Apify actor that fetches data from an optimized API to extract comprehensive details of real estate agents in Dubai. This scraper delivers fast, efficient results with minimal compute usage.

🎯 What does this actor do?

This actor:

1. Connects to a dedicated API to fetch Dubai real estate agent profiles.
2. Filters results by office name, agent rank, and other parameters.
3. Fetches agent data in optimized batches for maximum efficiency.
4. Extracts comprehensive data from each agent profile.
5. Returns structured agent data in JSON format.

📋 Input Parameters

The actor accepts the following input parameters:

{
  "officeName": "Emaar Properties",
  "cardRank": "A",
  "search": "John Doe",
  "activeOnly": true,
  "limit": 100,
  "offset": 0
}

Input Parameters

• limit (number, optional): Maximum number of agents to return.

  • Set to 0 for unlimited results (will fetch all available agents).
  • Default: 100

• offset (number, optional): Number of agents to skip (for pagination).

  • Default: 0

• officeName (string, optional): Filter agents by their office or agency name.

  • Example: "Emaar Properties"

• cardRank (string, optional): Filter agents by their professional card rank.

  • Example: "A", "B1"

• officeRank (string, optional): Filter agents by their office's rank.

  • Example: "Gold"

• activeOnly (boolean, optional): Only return agents with an active status.

  • Default: false

• search (string, optional): A general search term to find agents by name or other text fields.

  • Example: "John Doe"

Default Behavior

The scraper automatically:

• Fetches results in optimized batches for best performance.
• Processes 100 available results unless a different limit is set.
• Includes both active and inactive agents (configurable via activeOnly).
• Handles pagination automatically to retrieve the requested number of results.

📊 Output Data Structure

The actor outputs an array of agent objects with the following structure:

{
  "id": "broker-12345",
  "cardNumber": "BRN12345",
  "cardHolderNameEn": "John Doe",
  "cardHolderNameAr": "جون دو",
  "cardHolderEmail": "john.doe@example.com",
  "cardHolderMobile": "+971501234567",
  "cardIssueDate": "2023-01-15T00:00:00.000Z",
  "cardExpiryDate": "2026-01-14T00:00:00.000Z",
  "cardRank": "A",
  "officeNameEn": "Prime Properties LLC",
  "officeNameAr": "برايم بروبرتيز ذ",
  "officeRank": "Gold",
  "scrapedAt": "2025-10-02T10:00:00.000Z"
}

Data Fields Explanation

• Agent ID: Unique identifier for the agent (id).
• Card Details: Broker card number, issue date, and expiry date.
• Contact Information: Agent's full name (English and Arabic), email, and mobile number.
• Ranking: The agent's professional card rank (cardRank).
• Office Details: The agency's name (English and Arabic) and its official rank (officeRank).
• Metadata: Timestamp of when the data was scraped (scrapedAt).

Summary Statistics

The actor also provides summary statistics in the key-value store:

{
  "totalBrokers": 100,
  "requestedLimit": 100,
  "initialOffset": 0,
  "officeName": "Prime Properties LLC",
  "cardRank": null,
  "officeRank": "Gold",
  "activeOnly": true,
  "search": null,
  "scrapedAt": "2025-10-02T10:05:00.000Z"
}

🚀 Example Usage

Basic Search - Get the first 50 agents

{
  "limit": 50
}

Filtered Search - Find agents from a specific office

{
  "officeName": "Damac Properties",
  "activeOnly": true,
  "limit": 200
}

Advanced Search with Pagination

This example gets the second page of results for agents with an "A" rank.

{
  "cardRank": "A",
  "limit": 100,
  "offset": 100
}

Get All Available Results

{
  "limit": 0
}

⚙️ Key Features

• High Performance: Leverages an optimized API for fast data retrieval and minimal compute usage.
• Comprehensive Data: Extracts full agent profiles including contact details, rankings, and office information.
• Flexible Filtering: Search by office name, card rank, office rank, or a general search term.
• Unlimited Results: Set limit to 0 to fetch all available agents matching your criteria.
• Batch Processing: Efficient data retrieval in optimized batches.
• Active Agent Filter: Option to show only currently active agents.
• Pagination Support: Use offset and limit for controlled data retrieval of large datasets.

🔧 Troubleshooting

Common Issues

1. No Results Found:

   • Try broadening your search criteria (e.g., remove officeName or search term).
   • Check for exact spelling and capitalization in filter values.
   • Set activeOnly to false to include inactive agents.

2. Fewer Results Than Expected:

   • The total number of agents matching the criteria may be less than your specified limit.
   • If activeOnly is true, some agents may have been excluded.

3. Large Data Sets:

   • For very large result sets, consider using pagination with offset and limit to manage data in chunks.
   • Monitor your Apify compute units when fetching unlimited results (limit: 0).

4. Connection Issues:

   • The actor includes a 30-second timeout. If issues persist, check the Apify platform status and try again later.

📝 Important Notes

• Optimized Performance: This actor is designed for speed and efficiency, resulting in lower compute usage.
• Unlimited Results: Set limit to 0 to fetch all available agents. Be mindful of resource consumption for very large queries.
• Active Agents: By default, both active and inactive agents are returned. Set activeOnly to true to get only active agents.
• Data Freshness: Agent data is sourced from a regularly updated database, but details like contact information or rank may change over time.

🔒 Privacy & Legal

This actor retrieves data from a designated API. Users are responsible for:

• Using the data in compliance with all applicable laws and regulations.
• Using the data ethically and for legitimate business purposes.
• Not using the data for spam, harassment, or other unauthorized activities.

💬 Support

For issues, questions, or feature requests, please contact the actor maintainer through the Apify platform or leave feedback in the actor's discussion section.