Property Finder's five portals, with every filter, the agent's contact and the UAE's transactions
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.
- endpoints
- 18
- credits per call
- 1–3
1 credit per call≈ $1/1,000 calls1,000 free credits, no card
- Brand New | Luxury 1BR | Premium Finishes1,400,000 AED
- listing_ref
- MCC-S-77757-WD
- category
- buy
- Fully Furnished | High Floor | Spacious1,900,000 AED
- listing_ref
- MCC-S-80869-RN
- category
- buy
- Semi-detached | Biggest Layout | Best Location—
- listing_ref
- MCC-S-52731-VE
- category
- buy
18 active endpoints, on 1 and 3 credit tiers.
- POST/propertyfinder/v1/locations1 credit
- POST/propertyfinder/v1/search1 credit
- POST/propertyfinder/v1/property1 credit
- POST/propertyfinder/v1/price_trends1 credit
- POST/propertyfinder/v1/transactions1 credit
- POST/propertyfinder/v1/area3 credits
- POST/propertyfinder/v1/area_reviews1 credit
- POST/propertyfinder/v1/projects1 credit
Run the call yourself, on the real endpoint
Change a parameter and press Try it. The response on the right is what your code will receive.
Property Finder (UAE, Saudi Arabia, Qatar, Bahrain, Egypt) API
5 of 18 endpoints, ready to run
Search with the site's own filters
// Press "Try it" and this pane shows exactly what the // live site returned this second — including an empty // result, if that is the truth. No key, no account.
What Property Finder (UAE, Saudi Arabia, Qatar, Bahrain, Egypt) endpoints does ReefAPI ship?
18 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.
Every parameter, every allowed value →
Missing a Property Finder (UAE, Saudi Arabia, Qatar, Bahrain, Egypt) endpoint, or need a source we don't have yet?Contact us real people · same-day reply.How the Property Finder (UAE, Saudi Arabia, Qatar, Bahrain, Egypt) API works
Property Finder (UAE, Saudi Arabia, Qatar, Bahrain, Egypt) is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.
No OAuth app, no request signing, no per-site account. One key covers all 694 engines.
Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.
Credits, not seats. Failed and blocked calls are never charged, and nothing is cached: every call reads the source live.
One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.
From a community to its listings, its sale prices and the agents who sell there
Resolve the place, page through the listings, open each one, then check what similar units actually sold for.
Marina
The location id (50) every other action takes.
Up to 60 listings per page (25 by default), pages 1 to 50, with price, size, photos, agent and agency phone; the site's total (Dubai Marina had 3,978 for sale on 2026-11-15).
The full listing: description, every photo, permit link, agent and agency contact, local price trend and price comparison.
What 2-bedroom units in the area actually sold for, with the market summary.
A feed of asking prices next to registered sale prices, with a contact for every listing.
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"}'{
"ok": true,
"data": { … },
"meta": {
"api": "propertyfinder",
"endpoint": "search",
"mode": "live",
"latency_ms": …,
"record_count": …
},
"error": null
}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.
Property Finder coverage, measured
Every number below was read from live Property Finder data on 2026-11-15, in 333 calls across all 18 actions and five countries.
UAE 183,708 listings for sale and 165,618 for rent (commercial 7,961 and 33,721); 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.
UAE for sale 183,708: Dubai Marina 3,978, villas 34,574, 2 bedrooms 40,091, off-plan 83,489, private pool 22,334, price drop 1,992, listed in the last day 1,968. UAE for rent 165,618: priced monthly 11,420, furnished 46,298.
20 listings in five countries and five categories: price 19 of 19 printed pages, size 20 of 20, bedrooms 20 of 20, search row and listing the same record 20 of 20.
Pages 1 to 50 of any query, 25 listings per page by default and up to 60 (at most 3,000). newest and price-sorted searches returned 0 repeated listings over pages 1 to 3 of UAE rent and sale; featured, the site's default, re-ranks between calls.
Listing phone and WhatsApp on 861 of 861 listings measured; agency e-mail on all of them; agency phone on 826. The site publishes no e-mail for the agent.
UAE only. Dubai: 157,939 sales in the last 12 months, 525,692 in 3 years, 681,929 rent contracts; filters for type, bedrooms, price, size, period, seller, ready or off-plan, new or renewed and unit number. The first 500 rows of any query.
Agents: UAE 17,613, Egypt 4,509, Qatar 1,298, Bahrain 591, Saudi Arabia 313. Agencies: UAE 3,911, Egypt 772, Qatar 298, Bahrain 201, Saudi Arabia 109. New projects: UAE 2,995, Egypt 1,504.
Search pages 1 to 50 of a query (3,000 listings at 60 per page). No transaction history outside the UAE. No full developer directory on the site: developers are found by name. Agent review texts are not published, only the rating and the count.
What people build with Property Finder (UAE, Saudi Arabia, Qatar, Bahrain, Egypt)
The jobs this data is most often used for.
endpoints
credits per call
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.
What Property Finder (UAE, Saudi Arabia, Qatar, Bahrain, Egypt) data costs
The cheapest call here is 1 credit, so $15/mo (Pro) buys 10,000 of them — $1.50 per 1,000 credits. Credits roll over and never expire, and failed or blocked calls are not charged.
- 1,000 free credits on signup, no card
- One key, all 694 APIs, one credit pool
- Failed and blocked calls are never charged
- Credits roll over and never expire
Call it in two lines
Sign up, get 1,000 credits and one key that works on every engine. Then this is the whole protocol.
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"])Have a question? We got answers.
The questions people actually ask before wiring up Property Finder (UAE, Saudi Arabia, Qatar, Bahrain, Egypt).
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.
38 Real Estate APIs on the same key
One key, one credit pool, one response envelope. If you are pulling Property Finder (UAE, Saudi Arabia, Qatar, Bahrain, Egypt), you are one call away from the rest of the category — no second contract, no second integration.
Need something this API does not do?
Name the endpoint, the field, or a source we do not carry yet. We ship new APIs every week and you would be first to get the key. Real people read every message and reply the same day.
Try it on your own data before you pay anything
The call above is the real endpoint, not a recording. A free key gives you 1,000 credits, the other 693 APIs, and the same envelope everywhere.
Endpoints, parameters and credit costs on this page are read from the live catalog and cannot drift from what the API accepts. Field notes were captured on 2026-11-15.