Property Finder Scraper

Extract real-estate listings from Property Finder — the largest property portal in the Gulf — across the UAE, Saudi Arabia, Qatar, Bahrain, Egypt and Lebanon. Search by location name or scrape specific listings, and get clean, structured JSON with price, GPS coordinates, beds/baths, size, photos, agent phone & WhatsApp, RERA permit numbers and amenities.

Built on Property Finder's own mobile API, so it stays reliable when HTML-scraping tools break on every site redesign — and it returns data the website hides behind "call" buttons.

Who it's for

• Property investors & analysts — track prices, price-per-sqft, GPS and inventory across Dubai, Abu Dhabi, Riyadh, Doha and more for yield and market research.
• Real-estate agencies & lead-gen teams — pull agent and broker phone numbers, WhatsApp and email attached to every listing to build outreach lists.
• PropTech & SaaS developers — a stable JSON feed with consistent field names for portals, valuation models and CRMs.
• Researchers & journalists — regional housing datasets with permit/regulatory metadata.

Output fields

Each listing is one dataset row:

Field	Type	Description
id	string	Property Finder listing ID
reference	string	Agency listing reference
title	string	Listing headline
url	string	Public listing URL (share link)
country	string	Market code (ae, sa, qa, bh, eg, lb)
purpose	string	sale, rent, commercial-sale, commercial-rent
property_type	string	Apartment, Villa, Townhouse, …
completion_status	string	completed / off-plan
furnished	string	Furnishing status
price	number	Price in the market currency
currency	string	AED, SAR, QAR, BHD, EGP, …
price_period	string	sell, yearly, monthly, …
bedrooms / bathrooms	number	Room counts (studio = 0)
size / size_unit	number / string	Built-up area (sqft)
location	string	Full location path (community, city)
location_id	string	Property Finder location ID
latitude / longitude	number	GPS coordinates
zone_name	string	DLD/registry zone (detail mode)
listed_date	string	When the listing was posted
images	array	Photo URLs
contact_phone	string	Agent phone number
contact_whatsapp	string	Agent WhatsApp number
contact_email	string	Agent email
agent	object	Agent id, name, super-agent flag, languages
broker	object	Brokerage name, address, email, logo
rera	object	RERA/Trakheesi permit number, authority, validation URL (detail mode)
agent_license_no / licenses	string / array	Regulatory licenses (detail mode)
amenities	array	Amenity names (detail mode)
floor_plans	array	Floor-plan images (detail mode)
mortgage	object	Mortgage/finance metadata (detail mode)
transactions	array	Comparable price transactions (optional)
scraped_at	string	ISO-8601 scrape timestamp

High-value use cases

• Investment screening — export every 2-bed apartment for sale in Dubai Marina under AED 2M with GPS and price-per-sqft, then rank by yield.
• Lead generation — collect agent phone + WhatsApp for all listings in a community and push them straight into a CRM.
• Market monitoring — schedule a daily run per city and diff prices to catch reductions and new inventory.
• Compliance / verification — capture RERA permit numbers and validation URLs to verify that listings are legally registered.
• Portal & valuation models — feed a consistent JSON schema into an AVM or a comparison site.

Input parameters

Parameter	Type	Default	Description
country	string	ae	Market: ae, sa, qa, bh, eg, lb
category	string	sale	sale, rent, commercial_sale, commercial_rent, new_projects
location	string	—	Location name to auto-resolve (e.g. Dubai Marina)
locationIds	array	—	Exact location IDs (advanced; overrides location)
listingUrls	array	—	Direct listing URLs or IDs (direct mode)
propertyType	string	—	Apartment, Villa, Townhouse, …
minPrice / maxPrice	integer	—	Price range
bedrooms / bathrooms	array	—	Room-count filters (0 = studio)
minArea / maxArea	integer	—	Area range (sqft)
furnished	string	—	all, yes, no, partly
completionStatus	string	—	completed, off_plan
priceType	string	—	Rent period: daily, weekly, monthly, yearly
keywords	string	—	Free-text keywords
sort	string	featured	Result ordering
scrapeMode	string	full	full (detail enrichment) or fast (search fields only)
includeTransactions	boolean	false	Attach comparable price transactions
maxItems	integer	100	Stop after this many listings

Example input

{
    "country": "ae",
    "category": "sale",
    "location": "Dubai Marina",
    "propertyType": "apartment",
    "bedrooms": ["2"],
    "sort": "featured",
    "scrapeMode": "full",
    "maxItems": 50
}

Example output (one row, trimmed)

{
    "id": "14149907",
    "reference": "MPSP-21801",
    "title": "Upgraded | Marina View | Vacant",
    "url": "https://www.propertyfinder.ae/en/plp/...-14149907.html",
    "country": "ae",
    "purpose": "sale",
    "property_type": "Apartment",
    "price": 4000000,
    "currency": "AED",
    "bedrooms": 2,
    "bathrooms": 3,
    "size": 1536,
    "size_unit": "sqft",
    "location": "Stella Maris, Dubai Marina, Dubai",
    "latitude": 25.07001,
    "longitude": 55.13244,
    "contact_phone": "+9715xxxxxxxx",
    "contact_whatsapp": "+9714xxxxxxxx",
    "agent": { "id": "392924", "name": "Saif Rehman", "is_super_agent": true },
    "broker": { "id": "817", "name": "Metropolitan Premium Properties" },
    "rera": { "number": "7126082000", "authority_name": "METROPOLITAN…" },
    "amenities": ["Central A/C", "Balcony", "Shared Pool"],
    "scraped_at": "2026-07-26T10:00:00+00:00"
}

Scheduling & integrations

• Schedule runs (hourly/daily) from the Apify Console to keep a fresh dataset.
• Export to JSON, CSV, Excel or the API, or push to Google Sheets, Make, Zapier, Amazon S3 and webhooks.
• Trigger downstream flows with an Apify webhook on run completion.

Use it from an AI agent (MCP)

This Actor works with the Apify MCP server, so AI assistants (Claude, ChatGPT, VS Code) can call it as a tool — ask an agent to "find 3-bed villas for sale in Arabian Ranches with agent contacts" and it will run this scraper and return structured results.

FAQ

Which countries are supported? UAE, Saudi Arabia, Qatar, Bahrain, Egypt and Lebanon — pick with the country input.

Does it return agent phone numbers? Yes. Agent phone, WhatsApp and email are extracted from the listing contact options (and enriched in full mode).

How fresh is the data? Every run reads Property Finder live, so results reflect the site at run time. Schedule runs to track changes.

Fast vs full mode? fast returns search-result fields (price, location, GPS, agent phone) and is cheaper/quicker. full adds detail — description, amenities, RERA permit, floor plans.

Will it break like HTML scrapers? It's built on Property Finder's structured mobile API rather than fragile page HTML, so it's far more stable across site redesigns.

Is scraping this legal? The Actor collects publicly available listing data. You are responsible for using the output in line with Property Finder's terms and applicable laws (e.g. how you contact agents).

Can I scrape specific listings? Yes — pass listingUrls with share URLs or IDs for direct mode.