Property Finder (UAE, Saudi Arabia, Qatar, Bahrain, Egypt) API & Scraper
The Property Finder API returns property listings for sale and rent from propertyfinder.ae (United Arab Emirates), propertyfinder.sa (Saudi Arabia), propertyfinder.qa (Qatar), propertyfinder.bh (Bahrain) and propertyfinder.eg (Egypt) as JSON, with the agent's phone and WhatsApp, plus UAE sale and rent transactions, area guides, new projects and the agent and agency directories.
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
It reads all five portals logged out; pick one with country=ae, sa, qa, bh or eg. `search` takes the same filters the site offers (location, property type, bedrooms, bathrooms, price, size, plot size, price per area, furnishing, ready or off-plan, rent period, keyword, amenities, listing age, video or 360 tours, deal badges, handover date, payment plan, cheques, a point and radius) with 10 sort orders, 25 listings per page by default and up to 60, pages 1 to 50, and the site's own total: on 2026-11-15 the UAE had 183,708 listings for sale and 165,618 for rent, Egypt 171,316 for sale. Every search call reads the site's current results. `property` returns one listing in full: price and period, price per sqft, size, rooms, the description, every photo, amenities, the permit validation link, the agent and the agency with their phone, WhatsApp and e-mail as published, the agency's licence, the local price trend, the price comparison with the area and mortgage rates. `transactions` returns Dubai Land Department sales and rent contracts by area with a market summary (157,939 sales in Dubai in the last 12 months); transactions are published for the UAE only. `area` and `area_reviews` return the site's area guides and resident reviews; `projects`, `project`, `developers` and `developer` cover new off-plan projects; `agents`, `agent`, `agencies` and `agency` read the agent and agency directories, with each one's live listings.
What a Property Finder field actually contains
Fields that read differently from how they look. Every row was measured against live Property Finder data on 2026-11-15.
| Field | What it holds |
|---|---|
| price, price_period | The headline price the listing page prints, with its period: sell for sales, yearly / monthly / weekly / daily for rents. On 20 listings across five countries and five categories, 19 of 19 pages that print a price matched the search row and the listing exactly; the 20th page printed no price element and its own data held the same figure. |
| results vs spotlight vs projects | A search page mixes three kinds of rows. results are the ranked listings that total counts; spotlight are paid listings the site pins on top of page 1 (5 on the first UAE page, none on page 2); projects are new-project cards placed between listings. They come back in separate lists. |
| sort | featured is the site's default order and re-ranks between calls, so two pages of a featured search can share listings. newest lists the latest first; pages 1 to 3 of UAE rent and sale searches returned 0 repeated listings, and the order moves by the listings added between two page calls. The price and bedrooms sorts page without gaps (0 repeats over 3 pages). |
| size, size_unit | The listing's size in the unit of its portal: sqft on propertyfinder.ae, sqm on .sa, .qa, .bh and .eg. Egyptian and Bahraini pages print both (2,368 sqft / 220 sqm) and the field carries the sqm figure. 20 of 20 matched the page. |
| price_per_area | The listing's price per sqft (UAE) or sqm. Set on sales; rent listings carry none (0 of 116 rent rows measured). |
| agent, agency, contact | The agent (name, photo, position, languages, experience, listing count) and the agency (name, address, phone, e-mail, licence, agent count) as the listing publishes them. contact holds the listing's phone and WhatsApp numbers: present on 861 of 861 listings measured. The site publishes no e-mail in contact or on the agent (empty on every row); the agency e-mail is there on every row. |
| permit | UAE listings carry the Dubai Land Department permit validation link and the issuing broker licence (11 of 13 UAE listing pages); the permit number itself is not on the page. |
| listed_at, available_from | listed_at is the page's "Listed" date; available_from is "Available from". The source's last-refreshed date is empty on every listing measured and is returned as null. |
| transactions: price, sold_by, status | Each row is one Dubai Land Department transaction: the price, price per sqft, size, unit number, date, ready or off-plan, sold by developer or individual (sales), new or renewed (rent contracts), with the previous price and the change where the unit sold before. |
Search serves pages 1 to 50 of any query, 25 listings per page by default and up to 60 (at most 3,000 listings); narrow the filters to reach more. Transactions serve the first 500 rows of a query.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/propertyfinder/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"location_ids": "1",
"category": "buy",
"sort": "newest"
}
}{
"ok": true,
"meta": {
"api": "propertyfinder",
"endpoint": "search",
"mode": "live",
"latency_ms": 665.7,
"record_count": 25,
"bytes": 209279,
"cache_hit": false,
"upstream_requests": 1,
"total": 113129,
"spotlight_rows": 0,
"project_cards": 5,
"charged_credits": 1,
"version": "1.0.1",
"request_id": "7ed5780bdd6f4e01",
"fetched_at": "2026-11-15T22:38:35.222Z"
},
"data": {
"country": "ae",
"location": null,
"results": [
{
"id": "173780707",
"listing_ref": "MCC-S-77757-WD",
"url": "https://www.propertyfinder.ae/en/plp/buy/apartment-for-sale-dubai-jumeirah-village-triangle-district-4-belmont-residences-173780707.html",
"title": "Brand New | Luxury 1BR | Premium Finishes",
"description": "Property Highlights:\n\n- Built-Up Area: 829 sq. ft.\n- 1 Bedroom, 2 Bathrooms\n- Unfurnished\n- Ellington - Belmont Residences\n- Secondary Off-Plan Resale\n\nCommunity and Lifestyle Amenities:\n\n- Lap pool with sun loungers\n- Outdoor and indoor fitness areas\n- Yoga area and climbing walls\n- Indoor and outdoor kids' play areas\n- Courtyard and lounge area\n- Library wall and reading nook\n- EV charging station\n- Bicycle parking with maintenance stand\n- 24-hour security and CCTV\n- Landscaped community parks\n- Basketball and tennis courts\n\nLocation and Connectivity:\n\nBelmont Residences sits within Jumeirah",
"category": "buy",
"offering_type": "Residential for Sale",
"property_type": "Apartment",
"property_type_id": 1,
"price": 1400000,
"currency": "AED",
"price_period": "sell",
"price_hidden": false,
"price_per_area": 1688,
"price_per_area_unit": "sqft",
"price_per_plot_area": null,
"bedrooms": "1",
"bedrooms_count": 1,
"bathrooms": "2",
"bathrooms_count": 2,
"rooms": null,
"rooms_count": null,
"size": 829,
"size_unit": "sqft",
"plot_size": null,
"furnished": "NO",
"completion_status": "off_plan",
"listed_at": "2026-11-15T22:32:46Z",
"last_refreshed_at": null,
"location": {
"id": "12576",
"name": "Belmont Residences",
"full_name": "Belmont Residences, District 4, Jumeirah Village Triangle, Dubai",
"type": "TOWER",
"path": "1.74.16200.12576",
"path_name": "Dubai, Jumeirah Village Triangle, District 4",
"slug": "jumeirah-village-triangle-district-4-belmont-residences",
"latitude": 25.0447,
"longitude": 55.195,
"insights_url": null
},
"location_tree": [
{
"id": "[trimmed-depth]",
"name": "[trimmed-depth]",
"type": "[trimmed-depth]",
"slug": "[trimmed-depth]",
"level": "[trimmed-depth]"
},
{
"id": "[trimmed-depth]",
"name": "[trimmed-depth]",
"type": "[trimmed-depth]",
"slug": "[trimmed-depth]",
"level": "[trimmed-depth]"
},
{
"id": "[trimmed-depth]",
"name": "[trimmed-depth]",
"type": "[trimmed-depth]",
"slug": "[trimmed-depth]",
"level": "[trimmed-depth]"
}
],
"images": [
{
"full": "[trimmed-depth]",
"medium": "[trimmed-depth]",
"small": "[trimmed-depth]",
"thumbnail": "[trimmed-depth]",
"label": "[trimmed-depth]"
},
{
"full": "[trimmed-depth]",
"medium": "[trimmed-depth]",
"small": "[trimmed-depth]",
"thumbnail": "[trimmed-depth]",
"label": "[trimmed-depth]"
},
{
"full": "[trimmed-depth]",
"medium": "[trimmed-depth]",
"small": "[trimmed-depth]",
"thumbnail": "[trimmed-depth]",
"label": "[trimmed-depth]"
}
],
"images_count": 30,
"video_url": null,
"view_360_url": null,
"floor_plans": [],
"amenities": [
{
"code": "[trimmed-depth]",
"name": "[trimmed-depth]"
},
{
"code": "[trimmed-depth]",
"name": "[trimmed-depth]"
},
{
"code": "[trimmed-depth]",
"name": "[trimmed-depth]"
}
],
"agent": {
"id": "277471",
"name": "Hunter Steele Newman",
"slug": "hunter-steele-newman",
"profile_url": "https://www.propertyfinder.ae/en/agent/hunter-steele-newman-277471",
"image": "https://static.shared.propertyfinder.ae/media/images/agent_image/277471/0e880613-335f-4731-91f7-995ee78efb5d/260x200.jpg?v=87d3b5c00fc768898a2c8324a0791a68",
"email": null,
"position": null,
"languages": [
"[trimmed-depth]"
],
"is_super_agent": true,
"user_id": 128204,
"years_of_experience": null,
"total_properties": null,
"transactions_count": null,
"avg_whatsapp_response_time_min": null,
"rating_breakdown": null
},
"agency": {
"id": "911",
"name": "McCone Properties",
"slug": "mccone-properties-1012",
"profile_url": "https://www.propertyfinder.ae/en/broker/mccone-properties-1012-911",
"logo": "https://static.shared.propertyfinder.ae/media/images/client_logos/911/8b27ba77-fbed-4146-bdb0-d2156103f6d3/260x200.jpg",
"address": "Office 305, Building Onyx Tower 2, The Greens, n/a, Dubai,",
"email": "[redacted-email]",
"phone": "[redacted-phone]",
"license_number": null,
"total_properties": null,
"total_agents": null,
"total_super_agents": null,
"is_exclusive": null
},
"contact": {
"phone": "[redacted-phone]",
"whatsapp": "[redacted-phone]",
"whatsapp_link": "https://api.whatsapp.com/send?phone=+97145560345&text=Hello%2C%0AI+would+like+to+get+more+information+about+this+property%3A+%0A+%0AReference%3A+MCC-S-77757-WD%0AType%3A+Apartment%0APrice%3A+1%2C400%2C000+AED+%0ALocation%3A+Belmont+Residences+%0ALink%3A+https%3A%2F%2Fwww.propertyfinder.ae%2Fto%2F173780707%2Fen+%0A+%0AAny+changes+made+to+this+message+will+result+in+the+enquiry+not+being+sent+to+the+agent.",
"email": null
},
"permit": null,
"listing_level": "standard",
"payment_methods": [],
"utilities_price_type": "notSelected",
"mortgage_cashback": 0,
"live_viewing": null,
"travel_time_tags": [],
"flags": {
"verified": true,
"direct_from_developer": false,
"new_construction": false,
"available": true,
"featured": false,
"premium": false,
"new_insert": true,
"community_expert": false,
"cts": false,
"has_view_360": false,
"exclusive": false,
"broker_project_property": false,
"smart_ad": false,
"spotlight_listing": false,
"claimed_by_agent": false,
"under_offer_by_competitor": false,
"pf_exclusive": false,
"fhm": false,
"upgraded": false,
"extended": false,
"landscaped": false,
"great_value": false,
"high_demand": false,
"luxe": false,
"price_drop": false
},
"ranking": {
"rank_score": 93.76185607910156,
"quality_score": 100,
"rsp": 93.761856,
"rss": 93.761856,
"lead_value": 100
},
"position": 1
},
{
"id": "173780678",
"listing_ref": "MCC-S-80869-RN",
"url": "https://www.propertyfinder.ae/en/plp/buy/apartment-for-sale-dubai-jumeirah-village-circle-district-12-catch-residences-by-igo-173780678.html",
"title": "Fully Furnished | High Floor | Spacious",
"description": "Property Highlights:\n\n- Built-Up Area: 1,624 sq. ft.\n- 2 Bedrooms, 3 Bathrooms\n- Fully Furnished\n- High Floor\n- Spacious Layout\n- Vacant, Move in Now\n- IGO - Catch Residences, JVC\n\nCommunity and Lifestyle Amenities:\n\n- Resort-style infinity pool with waterfall feature\n- Miami-style sun deck with cabanas and loungers\n- Dedicated children's swimming pool\n- Fully equipped modern fitness centre\n- Outdoor BBQ and garden deck\n- Indoor games and recreation zone\n- Family entertainment spaces\n- 24/7 security and CCTV monitoring\n- Covered parking\n- Pet-friendly building\n- Landscaped parks and jogging pa",
"category": "buy",
"offering_type": "Residential for Sale",
"property_type": "Apartment",
"property_type_id": 1,
"price": 1900000,
"currency": "AED",
"price_period": "sell",
"price_hidden": false,
"price_per_area": 1169,
"price_per_area_unit": "sqft",
"price_per_plot_area": null,
"bedrooms": "2",
"bedrooms_count": 2,
"bathrooms": "3",
"bathrooms_count": 3,
"rooms": null,
"rooms_count": null,
"size": 1624,
"size_unit": "sqft",
"plot_size": null,
"furnished": "YES",
"completion_status": "completed",
"listed_at": "2026-11-15T22:31:14Z",
"last_refreshed_at": null,
"location": {
"id": "11662",
"name": "Catch Residences By IGO",
"full_name": "Catch Residences By IGO, District 12, Jumeirah Village Circle, Dubai",
"type": "TOWER",
"path": "1.[redacted-phone]",
"path_name": "Dubai, Jumeirah Village Circle, District 12",
"slug": "jumeirah-village-circle-district-12-catch-residences-by-igo",
"latitude": 25.0557,
"longitude": 55.2205,
"insights_url": null
},
"location_tree": [
{
"id": "[trimmed-depth]",
"name": "[trimmed-depth]",
"type": "[trimmed-depth]",
"slug": "[trimmed-depth]",
"level": "[trimmed-depth]"
},
{
"id": "[trimmed-depth]",
"name": "[trimmed-depth]",
"type": "[trimmed-depth]",
"slug": "[trimmed-depth]",
"level": "[trimmed-depth]"
},
{
"id": "[trimmed-depth]",
"name": "[trimmed-depth]",
"type": "[trimmed-depth]",
"slug": "[trimmed-depth]",
"level": "[trimmed-depth]"
}
],
"images": [
{
"full": "[trimmed-depth]",
"medium": "[trimmed-depth]",
"small": "[trimmed-depth]",
"thumbnail": "[trimmed-depth]",
"label": "[trimmed-depth]"
},
{
"full": "[trimmed-depth]",
"medium": "[trimmed-depth]",
"small": "[trimmed-depth]",
"thumbnail": "[trimmed-depth]",
"label": "[trimmed-depth]"
},
{
"full": "[trimmed-depth]",
"medium": "[trimmed-depth]",
"small": "[trimmed-depth]",
"thumbnail": "[trimmed-depth]",
"label": "[trimmed-depth]"
}
],
"images_count": 28,
"video_url": null,
"view_360_url": null,
"floor_plans": [],
"amenities": [
{
"code": "[trimmed-depth]",
"name": "[trimmed-depth]"
},
{
"code": "[trimmed-depth]",
"name": "[trimmed-depth]"
},
{
"code": "[trimmed-depth]",
"name": "[trimmed-depth]"
}
],
"agent": {
"id": "277471",
"name": "Hunter Steele Newman",
"slug": "hunter-steele-newman",
"profile_url": "https://www.propertyfinder.ae/en/agent/hunter-steele-newman-277471",
"image": "https://static.shared.propertyfinder.ae/media/images/agent_image/277471/0e880613-335f-4731-91f7-995ee78efb5d/260x200.jpg?v=87d3b5c00fc768898a2c8324a0791a68",
"email": null,
"position": null,
"languages": [
"[trimmed-depth]"
],
"is_super_agent": true,
"user_id": 128204,
"years_of_experience": null,
"total_properties": null,
"transactions_count": null,
"avg_whatsapp_response_time_min": null,
"rating_breakdown": null
},
"agency": {
"id": "911",
"name": "McCone Properties",
"slug": "mccone-properties-1012",
"profile_url": "https://www.propertyfinder.ae/en/broker/mccone-properties-1012-911",
"logo": "https://static.shared.propertyfinder.ae/media/images/client_logos/911/8b27ba77-fbed-4146-bdb0-d2156103f6d3/260x200.jpg",
"address": "Office 305, Building Onyx Tower 2, The Greens, n/a, Dubai,",
"email": "[redacted-email]",
"phone": "[redacted-phone]",
"license_number": null,
"total_properties": null,
"total_agents": null,
"total_super_agents": null,
"is_exclusive": null
},
"contact": {
"phone": "[redacted-phone]",
"whatsapp": "[redacted-phone]",
"whatsapp_link": "https://api.whatsapp.com/send?phone=+97145560345&text=Hello%2C%0AI+would+like+to+get+more+information+about+this+property%3A+%0A+%0AReference%3A+MCC-S-80869-RN%0AType%3A+Apartment%0APrice%3A+1%2C900%2C000+AED+%0ALocation%3A+Catch+Residences+By+IGO+%0ALink%3A+https%3A%2F%2Fwww.propertyfinder.ae%2Fto%2F173780678%2Fen+%0A+%0AAny+changes+made+to+this+message+will+result+in+the+enquiry+not+being+sent+to+the+agent.",
"email": null
},
"permit": null,
"listing_level": "standard",
"payment_methods": [],
"utilities_price_type": "notSelected",
"mortgage_cashback": 0,
"live_viewing": null,
"travel_time_tags": [],
"flags": {
"verified": true,
"direct_from_developer": false,
"new_construction": false,
"available": true,
"featured": false,
"premium": false,
"new_insert": true,
"community_expert": false,
"cts": false,
"has_view_360": false,
"exclusive": false,
"broker_project_property": false,
"smart_ad": false,
"spotlight_listing": false,
"claimed_by_agent": false,
"under_offer_by_competitor": false,
"pf_exclusive": false,
"fhm": false,
"upgraded": false,
"extended": false,
"landscaped": false,
"great_value": false,
"high_demand": false,
"luxe": false,
"price_drop": false
},
"ranking": {
"rank_score": 93.76264953613281,
"quality_score": 100,
"rsp": 93.76265,
"rss": 93.76265,
"lead_value": 100
},
"position": 2
},
{
"id": "173780534",
"listing_ref": "MCC-S-52731-VE",
"url": "https://www.propertyfinder.ae/en/plp/buy/villa-for-sale-dubai-dubai-islands-bay-villas-173780534.html",
"title": "Semi-detached | Biggest Layout | Best Location",
"description": "Bay Villas | Dubai Islands\n\nProperty highlights:\n• PLOT - 3,934 SQFT\n• BUA - 4,233 SQFT\n• 4 & 5 Bedroom Contemporary Villas\n• Expansive Living & Dining Areas\n• Large Terraces & Private Garden\n• Maid’s Room\n• Covered Parking\n• High-quality Finishing\n• Prime Location within the Community\n\nExperience elevated waterfront living in Bay Villas, one of the most anticipated villa communities on Dubai Islands. Surrounded by pristine beaches and open sea views, this is where privacy, luxury and future growth come together.\n\nThese modern villas are thoughtfully designed with spacious layouts, floor-to-ce",
"category": "buy",
"offering_type": "Residential for Sale",
"__trimmed": "response capped for page display"
}
],
"spotlight": [],
"__trimmed": "response capped for page display"
},
"__trimmed": "response capped for page display"
}What the Property Finder (UAE, Saudi Arabia, Qatar, Bahrain, Egypt) API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| locations | Look up places by name on one Property Finder portal and get the location ids every other action accepts: cities, communities, sub-communities and buildings, with coordinates, review score and the area-guide link. | Real-estate investors call locations to look up places by name on one Property Finder portal and get the location ids every other act…. | query, country, language, page, page_size |
| search | Search Property Finder listings on one portal with every filter and sort the site's own search takes, paged with the site's total. `results` are the ranked listings that `total` counts; `spotlight` holds the paid listings the site pins on top of every page, `projects` the new-project cards it mixes in. | Brokerage tools call search to search Property Finder listings on one portal with every filter and sort the site's own searc…. | country, language, category, location, location_ids, ... |
| property | Everything one listing page shows: price, price per area, size, rooms, furnishing, completion, the full description, every photo (and the community / building photos), amenities, the permit / RERA number and validation link, the agent and the agency with phone, WhatsApp and e-mail as published, the property and regulatory detail tables, local price trends (1 / 2 / 5 years), the price comparison against the area, similar sold / rented transactions and mortgage rates. | Property dashboards call property to get everything one listing page shows. | property_id, country, language |
| price_trends | Price trend of a community or building for one property type and bedroom count: monthly price per area (sale) or yearly rent, community line and building line, over 1, 2 and 5 years. | Lead-generation teams call price_trends to get price trend of a community or building for one property type and bedroom count. | location_id, country, language, category, property_type, ... |
| transactions | UAE (Dubai Land Department data as Property Finder publishes it): sold or rented transactions in a city, community or building with the market summary (average and median price, price per sqft, volume, yield, monthly trend). Filters: property type, bedrooms, price, size, period, seller (developer / individual), completion, new or renewed rent contracts, unit number. | Real-estate investors call transactions to get uAE (Dubai Land Department data as Property Finder publishes it). | location_id, category, property_type, bedrooms, min_price, ... |
| area | The site's area guide for a city, community or building: description, key facts, FAQs, getting around, schools, nearby places (counts and named places), demographics of renters, market insights (average sale price, price per sqft, yield, transaction volume), median prices per property type and bedroom count, price histogram, review summary with the latest reviews, popular buildings, similar communities and photos. | Brokerage tools call area to get the site's area guide for a city, community or building. | area, country, language |
| area_reviews | Resident reviews of a community or building (the area guide's reviews), paged and sortable, with the score per category (traffic, quiet, parks, family, maintenance, parking, amenities). | Property dashboards call area_reviews to get resident reviews of a community or building (the area guide's reviews), paged and sortable, w…. | location_id, country, language, sort, page, ... |
| projects | New (off-plan) projects on one portal, paged as the site's new-projects search shows them: name, developer, location, starting price and price range, bedrooms, property types, handover date, construction and sales phase, payment plans, down payment, amenities. Filters: location, developer, property type, bedrooms, price, handover date, ready / off-plan, post-handover payment plan. | Lead-generation teams call projects to get new (off-plan) projects on one portal, paged as the site's new-projects search shows them. | country, language, location_id, developer_id, property_type, ... |
| project | One new project: description, developer, master plan, location with coordinates, starting price and price range, unit types with sizes and prices, payment plans, handover and construction timeline, amenities, images, brochure, FAQs, agents marketing it, recent sales in the building and similar projects. | Real-estate investors call project to get one new project. | project, country, language |
| developers | Find property developers (and their projects) by name with the site's new-projects autocomplete. | Brokerage tools call developers to find property developers (and their projects) by name with the site's new-projects autocomplete.. | query, country, language, page_size |
| developer | A developer's page: profile (description, established since, projects online, logo), the developer's projects (first page, paged with `page`) and the per-city project counts. | Property dashboards call developer to get a developer's page. | developer, country, language, page |
| agents | Search the portal's agent directory: by name, area, language, nationality, service, property type, SuperAgent; paged with the site's total. | Lead-generation teams call agents to search the portal's agent directory. | country, language, name, location_id, spoken_language, ... |
| agent | One agent's public profile: bio, position, nationality, languages, experience, licence, listing counts by type, rating and review count with the distribution, WhatsApp response time, top locations, claimed transactions and the agency. | Real-estate investors call agent to get one agent's public profile. | agent_id, country, language |
| agent_listings | Every live listing of one agent, paged, with the same filters and sorting as `search`. | Brokerage tools call agent_listings to get every live listing of one agent, paged, with the same filters and sorting as `search`.. | agent_id, country, language, category, location, ... |
| agencies | Search the portal's agency (real-estate company) directory by name, area and service; paged with the site's total. | Property dashboards call agencies to search the portal's agency (real-estate company) directory by name, area and service; paged w…. | country, language, name, location_id, service, ... |
| agency | One agency's profile: name, licence, phone, e-mail, address, description, logo, listing counts by type, number of agents and SuperAgents, awards, branches. | Lead-generation teams call agency to get one agency's profile. | agency_id, country, language |
| agency_agents | Every agent of one agency, paged with the site's total. | Real-estate investors call agency_agents to get every agent of one agency, paged with the site's total.. | agency_id, country, language, sort, page, ... |
| agency_listings | Every live listing of one agency, paged, with the same filters and sorting as `search`. | Brokerage tools call agency_listings to get every live listing of one agency, paged, with the same filters and sorting as `search`.. | agency_id, country, language, category, location, ... |
Call search from your stack
curl -X POST https://api.reefapi.com/propertyfinder/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"location_ids":"1","category":"buy","sort":"newest"}'import os
import requests
REEF_KEY = os.environ["REEF_KEY"]
r = requests.post(
"https://api.reefapi.com/propertyfinder/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"location_ids": "1",
"category": "buy",
"sort": "newest"
},
timeout=90,
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/propertyfinder/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"location_ids": "1",
"category": "buy",
"sort": "newest"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.propertyfinder.search with {"location_ids":"1","category":"buy","sort":"newest"}.Who uses this API and why
- Track asking prices and rents per community in Dubai, Abu Dhabi, Riyadh, Doha, Manama and Cairo.
- Compare asking prices with Dubai Land Department transactions for the same building.
- Build a lead list of agents and agencies with their phone, WhatsApp, licence and live listing counts.
- Monitor new listings and price drops with sort=newest and the price_drop badge.
- Collect off-plan projects with developer, payment plans, handover dates and starting prices.
Questions developers ask before integrating
Is there a Property Finder API?
Yes. The propertyfinder API on ReefAPI returns the listings, full listing pages with the agent's contact, UAE transactions, area guides, new projects and agent and agency directories of all five Property Finder portals (UAE, Saudi Arabia, Qatar, Bahrain, Egypt) as JSON, read logged out, no Property Finder account needed.
Which countries are covered?
The United Arab Emirates (propertyfinder.ae), Saudi Arabia, Qatar, Bahrain and Egypt. Pass country=ae, sa, qa, bh or eg. On 2026-11-15: UAE 183,708 for sale and 165,618 for rent, Egypt 171,316 and 50,570, Qatar 12,370 and 34,897, Bahrain 9,264 and 15,865, Saudi Arabia 3,461 and 1,156. Transaction history is published for the UAE only.
Which filters does search take?
Location (a name or ids), property type, bedrooms, bathrooms, price, size, plot size, price per area, furnishing, ready or off-plan, rent period, keyword, full-text search, amenities, listed within 1 to 90 days, video / 360 / floor plan / live viewing, great value / high demand / price drop badges, handover dates, post-handover payment plan, upgraded / extended / landscaped, mortgage cashback, number of cheques, and a point with a radius. Each was checked against the unfiltered total on 2026-11-15: UAE listings for sale 183,708, in Dubai Marina 3,978, villas 34,574, 2 bedrooms 40,091, with a private pool 22,334, listed in the last day 1,968.
Do I get the agent's phone number?
Yes, as the listing publishes it: the listing's phone and WhatsApp numbers (861 of 861 listings measured), the agency's phone and e-mail, and the agent's profile. agents and agent return the agent directory with nationality, languages, experience, rating, review count and listing counts.
Where do the transactions come from?
From Property Finder's transaction pages, which publish Dubai Land Department data: sales and rent contracts by city, community or building, with price, size, unit number, date, developer, seller type and the market summary. Dubai had 157,939 sales in the last 12 months and 681,929 rent contracts on 2026-11-15. Saudi Arabia, Qatar, Bahrain and Egypt publish no transactions on Property Finder.
How deep can I page?
Search serves pages 1 to 50 of any query, 25 listings per page by default and up to 60, so up to 3,000 listings per query. Past page 50 the site answers from a different index that ignores the sort and the location filter, so the API stops there and says so. Transactions serve the first 500 rows of a query; agents and agencies page to the end of the directory (17,613 UAE agents, 881 pages of 20).
Which sort order should I page with?
One of the fixed orders. The price and bedrooms sorts page without gaps (0 repeated listings over 3 pages on 2026-11-15), and newest returned 0 repeats over pages 1 to 3 of UAE rent and sale searches, moving only by the listings added between two page calls. featured, the site's default, re-ranks between calls, so its pages can share listings.
Does it cover new projects and developers?
Yes. projects lists new off-plan projects with developer, starting price, price range, bedrooms, handover date, construction and sales phase and payment plans (2,995 in the UAE, 1,504 in Egypt on 2026-11-15); project returns one project with its units, payment plans, timeline, amenities and recent building sales; developer returns a developer's profile and projects. developers finds developers by name; the site publishes no full developer directory.
Can I get area guides and reviews?
Yes. area returns the site's guide for a city, community or building: description, key facts, FAQs, getting around, schools, nearby places, renter demographics, median prices by type and bedrooms, market insights and the latest reviews. area_reviews pages a community's or building's resident reviews with seven category scores and four sort orders.
What is the Property Finder (UAE, Saudi Arabia, Qatar, Bahrain, Egypt) API?
Property Finder (UAE, Saudi Arabia, Qatar, Bahrain, Egypt) API is a ReefAPI endpoint group for listings for sale and rent with every site filter, full listings with the agent's phone and whatsapp, uae transactions, area guides, new projects and agent directories. It returns live JSON through POST requests under /propertyfinder/v1.
Is the Property Finder (UAE, Saudi Arabia, Qatar, Bahrain, Egypt) API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. Property Finder (UAE, Saudi Arabia, Qatar, Bahrain, Egypt) calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Property Finder (UAE, Saudi Arabia, Qatar, Bahrain, Egypt) login or account?
No login to Property Finder (UAE, Saudi Arabia, Qatar, Bahrain, Egypt) is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the Property Finder (UAE, Saudi Arabia, Qatar, Bahrain, Egypt) data?
The page example is captured from a live locations call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the Property Finder (UAE, Saudi Arabia, Qatar, Bahrain, Egypt) API use?
Property Finder (UAE, Saudi Arabia, Qatar, Bahrain, Egypt) actions currently cost 1-3 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.