🏙️ UAE Real Estate Agent Search

⚡ NO Proxies Needed

Search for real estate agents by name across Bayut and PropertyFinder — UAE's two largest property platforms. Results from both sources are automatically normalised into a single, unified schema so you can work with clean, consistent data regardless of which platform it came from.

---

✨ What This Actor Does

• Accepts an agent name (full or partial) and one or both platforms as input
• Searches Bayut and/or PropertyFinder for matching agent profiles
• Normalises the results into a single flat schema with a source field so you always know where each record came from
• Handles pagination automatically — no manual setup required
• Returns contact details, agency info, listing counts, trust signals, ratings, languages, top locations, and license numbers

---

🚀 Quickstart

1. Enter an Agent Name — full name or partial (e.g. Anna, Ahmed, Sarah Johnson)
2. Select one or both Platforms (default: both)
3. Click Start and check the Dataset tab for results

That's it. For very common names with many pages, the actor fetches everything automatically.

---

⚙️ Input Parameters

Field	Type	Required	Description
agent_name	String	✅ Yes	Full or partial name of the agent to search for
platforms	Array	No	Platforms to search: bayut, propertyfinder, or both (default: both)
page	Integer	No	Page number for Bayut results (default: 1, 20 agents per page)

Platform behaviour

Bayut — paginated manually. The actor fetches the page you specify via the page input. Check the logs after each run for the next page number.

PropertyFinder — paginated automatically. The actor keeps fetching pages sequentially until it receives an empty page, so you always get all matching results in a single run — whether that's 1 result or 100+.

---

📦 Output Schema

Every result — regardless of platform — is returned in this normalised shape:

Field	Type	Notes
source	"bayut" | "propertyfinder"	Which platform this record came from
profile_url	String | null	Direct link to the agent's profile page
agent_id	String | null	Platform-native agent ID
name	String | null	Agent's full name
slug	String | null	URL slug
photo_url	String | null	Profile photo (PropertyFinder only)
position	String | null	Job title (PropertyFinder only)
bio	String | null	Agent bio / description (PropertyFinder only)
nationality	String | null	Nationality (PropertyFinder only)
languages	String[]	Languages spoken
experience_since	Integer | null	Year the agent started (PropertyFinder only)
email	String | null	Agent email (PropertyFinder only)
phone	String | null	Phone number
whatsapp	String | null	WhatsApp number (PropertyFinder only)
verified	Boolean | null	Platform-verified status (PropertyFinder only)
is_super_agent	Boolean | null	TruBroker badge on Bayut / SuperAgent on PropertyFinder
is_quality_lister	Boolean | null	Quality Lister badge (Bayut only)
is_highly_responsive	Boolean | null	Highly Responsive badge (Bayut only)
average_rating	Float | null	Average review score (PropertyFinder only)
review_count	Integer | null	Number of reviews (PropertyFinder only)
ranking	Integer | null	Platform ranking (PropertyFinder only)
total_properties	Integer | null	Total active listings
properties_for_sale	Integer | null	Active sale listings
properties_for_rent	Integer | null	Active rental listings
top_locations	String[]	Areas the agent is most active in
license_number	String | null	RERA number (Bayut) / BRN number (PropertyFinder)
agency_id	String | null	Agency's platform ID
agency_name	String | null	Agency name
agency_logo_url	String | null	Agency logo image URL

Note on null fields: Some fields are platform-specific and will always be null for the other platform. This is by design — the schema is unified so your downstream code handles one consistent shape regardless of source.

---

📊 Dataset Views

The actor registers two table views in the Apify dataset UI:

• Agents — compact view with the most actionable fields: name, contact, agency, listings, trust badges, profile URL
• Agents (Full) — all normalised fields including bio, nationality, languages, top locations, and rating distribution

---

🔁 Pagination Guide

Bayut

Bayut returns 20 agents per page. The actor fetches one page per run.

After each run, check the Logs tab for a summary like:

PLATFORM A PAGINATION:
  Page     : 1 of 4
  This page: 20 agents
  Total    : 68 agents
  Per page : 20
  Next page: Run again with page = 2

To get the next page, re-run the actor with page = 2, page = 3, and so on.

PropertyFinder

PropertyFinder is fully automatic — the actor fetches all pages in a single run and stops as soon as an empty page is returned. You will see page-by-page progress in the logs:

Platform B: Page 1 — retrieved 10 result(s).
Platform B: Page 2 — retrieved 10 result(s).
Platform B: Page 3 — retrieved 3 result(s).
Platform B: 23 total result(s) fetched across 3 pages.

For a rare name with only 1–2 results, the actor fetches a single page and stops immediately — no extra requests are made.

---

💡 Usage Examples

Find all agents named "Anna" on both platforms

{
  "agent_name": "Anna",
  "platforms": ["bayut", "propertyfinder"]
}

Search only on Bayut, page 2

{
  "agent_name": "Mohammed",
  "platforms": ["bayut"],
  "page": 2
}

Quick lookup on PropertyFinder only

{
  "agent_name": "Sarah Johnson",
  "platforms": ["propertyfinder"]
}

---

🔗 Related Actors

If you need more than agent search, check out the other actors in this series:

• Bayut Property Scraper — scrape property listings from Bayut with filters for location, price, type, and more
• Bayut Agent Finder — full agent workflow on Bayut: location search → agent search → agent details → agent's property listings

---

❓ FAQ

What if the same agent appears on both platforms? They will appear as two separate records — one with source: "bayut" and one with source: "propertyfinder". You can de-duplicate on name + agency_name or slug if needed downstream.

Why are some fields null for Bayut results? Bayut's agent search endpoint returns a lightweight summary — it does not expose email, bio, photo, nationality, or rating data at the search level. Use the Bayut Agent Finder actor's "Agent Details" mode to get the full profile for a specific agent.

Why is photo_url always null for Bayut? Bayut returns an internal image ID rather than a public-facing URL at this data level. The field is kept in the schema for consistency and may be populated in a future update.

The actor returned no results — what should I try?

• Check the spelling of the agent name
• Try a shorter / partial name (e.g. Anna instead of Anna Smirnova)
• Make sure at least one platform is selected
• Check the Logs tab for any platform-specific error messages

How to rech out to us? Email use at happyendpointhq@gmail.com.