Property Finder (UAE, Saudi Arabia, Qatar, Bahrain, Egypt) API

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

POST/propertyfinder/v1/search200
  1. Brand New | Luxury 1BR | Premium Finishes1,400,000 AED
    listing_ref
    MCC-S-77757-WD
    category
    buy
  2. Fully Furnished | High Floor | Spacious1,900,000 AED
    listing_ref
    MCC-S-80869-RN
    category
    buy
  3. Semi-detached | Biggest Layout | Best Location—
    listing_ref
    MCC-S-52731-VE
    category
    buy
Real result, captured Nov 15, 20263 of 25
Try it live

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

View docs ↗

Search with the site's own filters

1 credit0 required · 6 optional
POST/propertyfinder/v1/search
idle
// 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.

Try every endpoint in the playground

Endpoints

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.

18 endpoints

locations

1 cr

Look up places by name on one Property Finder portal and get the location ids every other act…

required
query
optional
country, language, page, page_size

search

1 cr

Search Property Finder listings on one portal with every filter and sort the site's own searc…

required
—
optional
country, language, category, location, location_ids, property_type, bedrooms, bathrooms, min_price, max_price, min_area, max_area, min_plot_size, max_plot_size, min_price_per_area, max_price_per_area, furnished, completion_status, price_period, keywords, text, listed_within, amenities, mortgage_cashback, virtual_viewings, deal_badges, delivery_date_from, delivery_date_to, post_handover_payment_plan, upgraded, extended, landscaped, min_cheques, max_cheques, latitude, longitude, radius_km, sort, page, page_size

property

1 cr

Everything one listing page shows.

required
property_id
optional
country, language

price_trends

1 cr

Price trend of a community or building for one property type and bedroom count.

required
location_id
optional
country, language, category, property_type, bedrooms

transactions

1 cr

UAE (Dubai Land Department data as Property Finder publishes it).

required
location_id
optional
category, property_type, bedrooms, min_price, max_price, min_area, max_area, period, sold_by, completion_status, contract_status, unit_number, page, page_size, language, country

area

3 cr

The site's area guide for a city, community or building.

required
area
optional
country, language

area_reviews

1 cr

Resident reviews of a community or building (the area guide's reviews), paged and sortable, w…

required
location_id
optional
country, language, sort, page, page_size

projects

1 cr

New (off-plan) projects on one portal, paged as the site's new-projects search shows them.

required
—
optional
country, language, location_id, developer_id, property_type, bedrooms, min_price, max_price, completion_status, delivery_date_from, post_handover_payment_plan, sort, page

project

1 cr

One new project.

required
project
optional
country, language

developers

1 cr

Find property developers (and their projects) by name with the site's new-projects autocomplete.

required
query
optional
country, language, page_size

developer

1 cr

A developer's page.

required
developer
optional
country, language, page

agents

1 cr

Search the portal's agent directory.

required
—
optional
country, language, name, location_id, spoken_language, nationality, service, property_type, super_agent, agency_id, sort, page, page_size

agent

1 cr

One agent's public profile.

required
agent_id
optional
country, language

agent_listings

1 cr

Every live listing of one agent, paged, with the same filters and sorting as search.

required
agent_id
optional
country, language, category, location, location_ids, property_type, bedrooms, bathrooms, min_price, max_price, min_area, max_area, min_plot_size, max_plot_size, min_price_per_area, max_price_per_area, furnished, completion_status, price_period, keywords, text, listed_within, amenities, mortgage_cashback, virtual_viewings, deal_badges, delivery_date_from, delivery_date_to, post_handover_payment_plan, upgraded, extended, landscaped, min_cheques, max_cheques, latitude, longitude, radius_km, sort, page, page_size

agencies

1 cr

Search the portal's agency (real-estate company) directory by name, area and service.

required
—
optional
country, language, name, location_id, service, sort, page, page_size

agency

1 cr

One agency's profile.

required
agency_id
optional
country, language

agency_agents

1 cr

Every agent of one agency, paged with the site's total.

required
agency_id
optional
country, language, sort, page, page_size

agency_listings

1 cr

Every live listing of one agency, paged, with the same filters and sorting as search.

required
agency_id
optional
country, language, category, location, location_ids, property_type, bedrooms, bathrooms, min_price, max_price, min_area, max_area, min_plot_size, max_plot_size, min_price_per_area, max_price_per_area, furnished, completion_status, price_period, keywords, text, listed_within, amenities, mortgage_cashback, virtual_viewings, deal_badges, delivery_date_from, delivery_date_to, post_handover_payment_plan, upgraded, extended, landscaped, min_cheques, max_cheques, latitude, longitude, radius_km, sort, page, page_size

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 it works

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.

01
Authenticate
x-api-key header

No OAuth app, no request signing, no per-site account. One key covers all 694 engines.

02
Call
POST /propertyfinder/v1/…

Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.

03
Pay
1 or 3 credits per call

Credits, not seats. Failed and blocked calls are never charged, and nothing is cached: every call reads the source live.

04
Read
{ ok, data, meta, error }

One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.

Recipe

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.

01locations?query=Dubai
GET/propertyfinder/v1/locations?query=Dubai
Marina

The location id (50) every other action takes.

02search?location_ids=50&category=buy&bedrooms=2&sort=newest&page_size=60
GET/propertyfinder/v1/search?location_ids=50&category=buy&bedrooms=2&sort=newest&page_size=60

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).

03property?property_id=<id>
GET/propertyfinder/v1/property?property_id=<id>

The full listing: description, every photo, permit link, agent and agency contact, local price trend and price comparison.

04transactions?location_id=50&bedrooms=2
GET/propertyfinder/v1/transactions?location_id=50&bedrooms=2

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.

request
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"}'
response envelope
{
  "ok": true,
  "data": { … },
  "meta": {
    "api": "propertyfinder",
    "endpoint": "search",
    "mode": "live",
    "latency_ms": …,
    "record_count": …
  },
  "error": null
}
Fields

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.

FieldWhat it holds
price, price_periodThe 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 projectsA 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.
sortfeatured 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_unitThe 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_areaThe listing's price per sqft (UAE) or sqm. Set on sales; rent listings carry none (0 of 116 rent rows measured).
agent, agency, contactThe 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.
permitUAE 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_fromlisted_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, statusEach 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.

Coverage

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.

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.

Filters that bite

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.

Price accuracy

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.

Paging and sort

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.

Agent contact

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.

Transactions

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.

Directories

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.

Limits

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.

Use cases

What people build with Property Finder (UAE, Saudi Arabia, Qatar, Bahrain, Egypt)

The jobs this data is most often used for.

18

endpoints

1/3

credits per call

01

Track asking prices and rents per community in Dubai, Abu Dhabi, Riyadh, Doha, Manama and Cairo.

02

Compare asking prices with Dubai Land Department transactions for the same building.

03

Build a lead list of agents and agencies with their phone, WhatsApp, licence and live listing counts.

04

Monitor new listings and price drops with sort=newest and the price_drop badge.

Pricing

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.

Full pricing →
$0.67–$1.50 / 1,000 credits
  • 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
no credit card1,000 free credits · instant API key · pay by card or crypto
Quickstart

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
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"}'
python
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"])
FAQ

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.

Same key

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.

Contact

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.

0/4000

No account needed · we reply from [email protected]

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.