Reef AI: ask for any data. Try it
Bayut (UAE, Saudi Arabia, Jordan, Bahrain, Oman, Qatar) API

Bayut's listings, with every filter, the exact total and the agent's contact

endpoints
14
credits per call
2

Bayut (bayut.com) is one of the largest property portals in the United Arab Emirates, with sister portals in Saudi Arabia, Jordan, Bahrain, Oman and Qatar.

/bayut/v1

  • POST/bayut/v1/locations2 credits
  • POST/bayut/v1/search2 credits
  • POST/bayut/v1/count2 credits
  • POST/bayut/v1/listing2 credits
  • POST/bayut/v1/listings2 credits
  • POST/bayut/v1/projects2 credits
  • POST/bayut/v1/project2 credits
  • POST/bayut/v1/agents2 credits
  • POST/bayut/v1/agent2 credits
  • POST/bayut/v1/agent_listings2 credits
14 active endpoints. Every call is 2 credits.+4 more, every parameter ↓OpenAPI 3.0 spec ↗

2 credits per call≈ $2/1,000 calls1,000 free credits, no card

Get a free API key
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.

Bayut (UAE, Saudi Arabia, Jordan, Bahrain, Oman, Qatar) API

5 of 14 endpoints, ready to run

View docs ↗

Search with the site's own filters

2 credits0 required · 5 optional
POST/bayut/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 Bayut (UAE, Saudi Arabia, Jordan, Bahrain, Oman, Qatar) endpoints does ReefAPI ship?

14 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.

  • locations

    2 cr

    Bayut's own location search box.

    required
    query
    optional
    country, language, type, page, limit
  • search

    2 cr

    Search Bayut listings for sale or for rent with every filter and sort the site's own search s…

    required
    —
    optional
    country, language, purpose, location, location_ids, category, query, price_min, price_max, bedrooms, bedrooms_min, bedrooms_max, bathrooms, bathrooms_min, bathrooms_max, area_min, area_max, rent_frequency, furnishing, completion_status, sale_type, verified, trubroker, has_video, has_360_tour, has_floor_plan, amenities, agency_id, agent_id, developer_id, posted_within_days, latitude, longitude, radius_km, sort, page, limit
  • count

    2 cr

    How many live listings match a search (same filters as search, no rows).

    required
    —
    optional
    country, purpose, location, location_ids, category, query, price_min, price_max, bedrooms, bedrooms_min, bedrooms_max, bathrooms, bathrooms_min, bathrooms_max, area_min, area_max, rent_frequency, furnishing, completion_status, sale_type, verified, trubroker, has_video, has_360_tour, has_floor_plan, amenities, agency_id, agent_id, developer_id, posted_within_days, latitude, longitude, radius_km
  • listing

    2 cr

    Everything one listing page shows.

    required
    listing_id
    optional
    country, language
  • listings

    2 cr

    Up to 50 listings by id in ONE upstream request (the site's own search index), e.g.

    required
    listing_ids
    optional
    country, language
  • projects

    2 cr

    New projects (off-plan and recently completed) as the site's new-projects search lists them.

    required
    —
    optional
    country, language, query, location, location_ids, developer_id, completion_status, page, limit
  • project

    2 cr

    One new project.

    required
    project_id
    optional
    country, language
  • agents

    2 cr

    Search Bayut's agent directory (bayut.com and bayut.sa) by name, area, emirate, spoken langua…

    required
    —
    optional
    country, language, query, location, emirate, spoken_language, speciality, agency_id, trubroker, page, limit
  • agent

    2 cr

    One agent's profile as the broker page shows it.

    required
    agent_id
    optional
    country, language
  • agent_listings

    2 cr

    One agent's live listings, with the same filters and sorts as search.

    required
    agent_id
    optional
    country, language, purpose, location, location_ids, category, query, price_min, price_max, bedrooms, bedrooms_min, bedrooms_max, bathrooms, bathrooms_min, bathrooms_max, area_min, area_max, rent_frequency, furnishing, completion_status, sale_type, verified, trubroker, has_video, has_360_tour, has_floor_plan, amenities, agency_id, agent_id, developer_id, posted_within_days, latitude, longitude, radius_km, sort, page, limit
  • agencies

    2 cr

    Search Bayut's agency directory.

    required
    —
    optional
    country, language, query, type, location, page, limit
  • agency

    2 cr

    One agency's profile.

    required
    agency_id
    optional
    country, language
  • agency_agents

    2 cr

    Every agent of one agency with e-mail, mobile, WhatsApp, languages, badges and listing counts.

    required
    agency_id
    optional
    country, language, page, limit
  • agency_listings

    2 cr

    One agency's live listings, with the same filters and sorts as search.

    required
    agency_id
    optional
    country, language, purpose, location, location_ids, category, query, price_min, price_max, bedrooms, bedrooms_min, bedrooms_max, bathrooms, bathrooms_min, bathrooms_max, area_min, area_max, rent_frequency, furnishing, completion_status, sale_type, verified, trubroker, has_video, has_360_tour, has_floor_plan, amenities, agency_id, agent_id, developer_id, posted_within_days, latitude, longitude, radius_km, sort, page, limit

Every parameter, every allowed value →

Missing a Bayut (UAE, Saudi Arabia, Jordan, Bahrain, Oman, Qatar) endpoint, or need a source we don't have yet?Contact us real people · same-day reply.
How it works

How the Bayut (UAE, Saudi Arabia, Jordan, Bahrain, Oman, Qatar) API works

Bayut (UAE, Saudi Arabia, Jordan, Bahrain, Oman, Qatar) is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.

Authenticate01
x-api-key header

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

Call02
POST /bayut/v1/…

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

Pay03
2 credits per call

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

Read04
{ ok, data, meta, error }

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

Recipe

From an area to its rentals, each listing in full and the agents who work there

Count the supply, page through the listings, open each one, then find the agents active in the same area.

01count?purpose=for_rent&location=Dubai
GET/bayut/v1/count?purpose=for_rent&location=Dubai
Marina&bedrooms=2&price_max=150000

The exact number that match (1,410 on 2026-11-19).

02search?purpose=for_rent&location=Dubai
GET/bayut/v1/search?purpose=for_rent&location=Dubai
Marina&bedrooms=2&price_max=150000&sort=newest

25 listings per page by default (up to 100) with price, area, location path, photos, agent and agency.

03listing?listing_id=16022649
GET/bayut/v1/listing?listing_id=16022649

The full listing: description, every photo, amenities, videos, the agent's BRN, mobile, WhatsApp and e-mail, the agency's licence.

04agents?location=Dubai
GET/bayut/v1/agents?location=Dubai
Marina&spoken_language=ru

Agents with live listings in the area who speak Russian (482 on 2026-11-19), with e-mail and mobile.

Every 2-bedroom rental under AED 150,000 in the area, each with its full listing and its agent's contact.

request
curl -X POST https://api.reefapi.com/bayut/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"purpose":"for_rent","location":"Dubai","sort":"newest"}'
response envelope
{
  "ok": true,
  "data": { … },
  "meta": {
    "api": "bayut",
    "endpoint": "search",
    "mode": "live",
    "latency_ms": …,
    "record_count": …
  },
  "error": null
}
Fields

What a Bayut field actually contains

Fields that read differently from how they look. Every row was measured against live Bayut data on 2026-11-19.

FieldWhat it holds
price, rent_frequencyThe price the listing page prints, in the portal's currency (AED on bayut.com), with the rent period for rentals (yearly, monthly, weekly, daily). On 8 listings in 8 categories (apartment, villa, townhouse, office, plot, industrial land, monthly rental, shop) the price, bedrooms, bathrooms, area, purpose, rent period, furnishing, reference, reactivated date and agent name matched the page on 119 of 120 checks.
area_sqm, area_sqftBayut stores the area in square metres; the page prints square feet. Both are returned (31.31 m² = the page's 337 sqft). The area_min / area_max filters take square feet, as the site does.
total, total_is_exactThe exact number of listings that match, the same whatever the sort (Dubai apartments for rent: 108,233 on the popular, newest, lowest-price and verified orders). total_is_exact is the source's own flag; it was true on 40 of 41 measured listing filters.
phones.whatsapp_button_numberThe number behind the listing's WhatsApp button. On 195 of 200 listings it is Bayut's shared WhatsApp line (+971545695868), not the agent's own phone; whatsapp_is_bayut_line says which. The agent's own WhatsApp, mobile and e-mail are in listing.agent and in agent.
phones.call_tracking_phoneThe tracked number the site's Call button dials. The agent's own mobile and landline are phones.mobile and phones.phone.
agent.brn, agency.licensesThe agent's Broker Registration Number and the agency's RERA / ORN licence numbers, as the listing and broker pages print them. BRN was published on 3 of 8 listings checked; agency licences on the listing pages that carry them.
is_verified, verified_atTruCheck: is_verified is the site's verified badge and verified_at its date. last_verification_check_at is the source's check date, also set on listings that are not verified.
reactivated_at, posted_atreactivated_at is the date the page prints as the listing date (8 of 8 matched, Dubai time); posted_at is when the listing was first created.

A search serves the first 50,000 results (page × limit up to 50,000); narrow the filters to reach more. The listing's DLD permit number, Dubai Land Department transactions and price trends are loaded only inside a browser session on Bayut and are not returned.

Coverage

Bayut coverage, measured

Every number below was read from live Bayut data on 2026-11-19, in over 180 calls across all 14 actions and six countries.

Countries

UAE 270,835 listings for sale and 308,771 for rent (commercial 15,262 and 50,553); Saudi Arabia 73,834 and 40,249; Jordan 16,847 and 6,883; Bahrain 229 and 2,865; Oman 1,493 and 1,184; Qatar 45 and 1,359.

Filters that bite

Dubai for rent 167,457: apartments 108,261, 2 or 3 bedrooms 51,161, studio 50,982, monthly 10,368, furnished 67,323, TruCheck 34,911, floor plan 38,013, video 3,510, 360 tour 1,430, posted in the last 7 days 16,711, within 1 km of Dubai Marina 5,796. Dubai for sale 125,804: ready 54,622, off-plan 71,182 (from the developer 40,056, resale 30,833).

Value accuracy

8 listings in 8 categories against the listing page: price, bedrooms, bathrooms, area, purpose, rent period, furnishing, reference, listing date and agent 119 of 120 checks; the one miss is a label (the page says Residential Plot, the source's type name is Plot).

Paging

Exact total on every sort; no listing repeated across pages 1-3 of five sorts, a keyword search and a Saudi search; full walks returned 277 of 277 and 636 of 636 listings.

Directories

UAE: 20,252 agents, 13,836 agencies (1,435 developers), 3,029 new projects (2,548 off-plan). Saudi Arabia: 2,175 agents, 4,110 agencies, 156 projects.

Limits

A search serves its first 50,000 results. Agents and new projects exist on bayut.com and bayut.sa only. DLD transactions, price trends and the listing's permit number are not returned (Bayut serves them only inside a browser session). The agent's BRN is published on some listings only (3 of 8 checked).

Use cases

What people build with Bayut (UAE, Saudi Arabia, Jordan, Bahrain, Oman, Qatar)

The jobs this data is most often used for.

01

Track asking prices and rents per community and building in Dubai, Abu Dhabi and Sharjah.

02

Build a lead list of agents and agencies with BRN, RERA licence, mobile, WhatsApp and e-mail.

03

Monitor new listings in an area with sort=newest and posted_within_days.

04

Collect off-plan projects with developer, completion date, progress and payment plan.

14

endpoints

2

credits per call

Pricing

What Bayut (UAE, Saudi Arabia, Jordan, Bahrain, Oman, Qatar) data costs

The cheapest call here is 2 credits, so $15/mo (Pro) buys 5,000 of them — $1.50 per 1,000 credits. Credits roll over and never expire, and failed or blocked calls are not charged.

$0.67–$1.50 / 1,000 credits
Full pricing →
  • 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/bayut/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"purpose":"for_rent","location":"Dubai","sort":"newest"}'
python
import os
import requests

REEF_KEY = os.environ["REEF_KEY"]

r = requests.post(
    "https://api.reefapi.com/bayut/v1/search",
    headers={"x-api-key": REEF_KEY},
    json={
        "purpose": "for_rent",
        "location": "Dubai",
        "sort": "newest"
    },
    timeout=90,
)
print(r.json()["data"])
FAQ

Have a question? We got answers.

The questions people actually ask before wiring up Bayut (UAE, Saudi Arabia, Jordan, Bahrain, Oman, Qatar).

Do I need a Bayut account?▾

No. Everything is read logged out.

Which countries are covered?▾

The United Arab Emirates (bayut.com) and the sister portals in Saudi Arabia, Jordan, Bahrain, Oman and Qatar: pass country=ae, sa, jo, bh, om or qa. On 2026-11-19: UAE 270,835 for sale and 308,771 for rent; Saudi Arabia 73,834 and 40,249; Jordan 16,847 and 6,883; Bahrain 229 and 2,865; Oman 1,493 and 1,184; Qatar 45 and 1,359. Agent directories exist for the UAE (20,252 agents) and Saudi Arabia (2,175); new projects for the UAE (3,029) and Saudi Arabia (156).

Which filters does search take?▾

Location (a name, slug or id; several ids are OR-ed), property type, keyword, price, bedrooms (studio, 1, 2 … and N+), bathrooms, area in sqft, rent period, furnishing, ready or off-plan, off-plan sale type (from the developer or resale), TruCheck verified, TruBroker agent, video, 360 tour, floor plan, amenities, agency, agent, developer, posted within N days and a radius around a point. Each one was measured against the same base search: Dubai rentals 167,457, apartments 108,261, 2 or 3 bedrooms 51,161, monthly 10,368, furnished 67,323, TruCheck 34,911, with a 360 tour 1,430.

Do I get the agent's phone number and e-mail?▾

Yes, as Bayut publishes them. Search rows carry the agent's name and id, the contact phones and the agency; listing adds the agent's BRN, mobile, WhatsApp, e-mail, languages and years of experience and the agency's RERA / ORN licence. agents and agent return the agent directory with e-mail, mobile, WhatsApp, specialities, service areas and listing counts.

How do I page through all results?▾

page and limit (1-100 rows). total is the exact count; consecutive pages had no repeated listing on any of the five sorts. A full walk of an agency's 277 listings and of 636 studio rentals in Dubai Marina returned every listing once. A search serves its first 50,000 results; past the last page the API answers NOT_FOUND.

Does it cover off-plan projects?▾

Yes. projects lists new projects with developer, location, unit types, starting price where the developer publishes one, completion date and progress, payment plan, amenities, description and the number of live listings (1,999 off-plan projects in Dubai on 2026-11-19). search takes completion_status=off_plan and sale_type=new or resale; listing returns the full payment plan.

Can I refresh many listings at once?▾

listings takes up to 50 listing ids and answers in one call with the current price, status and agent of each; ids that are no longer live come back in missing_ids.

Are Dubai Land Department transactions or price trends included?▾

No. Bayut loads its transaction history, price trends and the listing's DLD permit number only inside a browser session, so they are not part of this API. The listing returns Bayut's DLD reference ids for the property and the building.

What is the Bayut (UAE, Saudi Arabia, Jordan, Bahrain, Oman, Qatar) API?▾

Bayut (UAE, Saudi Arabia, Jordan, Bahrain, Oman, Qatar) API is a ReefAPI endpoint group for property listings for sale and rent with every site filter and exact totals, full listings with the agent's brn, mobile, whatsapp and e-mail, new projects, agents and agencies. It returns live JSON through POST requests under /bayut/v1.

Is the Bayut (UAE, Saudi Arabia, Jordan, Bahrain, Oman, Qatar) API free to try?▾

Yes. ReefAPI starts with 1,000 free credits, no card required. Bayut (UAE, Saudi Arabia, Jordan, Bahrain, Oman, Qatar) calls use the same shared credit balance as every other ReefAPI engine.

Do I need a Bayut (UAE, Saudi Arabia, Jordan, Bahrain, Oman, Qatar) login or account?▾

No login to Bayut (UAE, Saudi Arabia, Jordan, Bahrain, Oman, Qatar) 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 Bayut (UAE, Saudi Arabia, Jordan, Bahrain, Oman, Qatar) 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 Bayut (UAE, Saudi Arabia, Jordan, Bahrain, Oman, Qatar) API use?▾

Bayut (UAE, Saudi Arabia, Jordan, Bahrain, Oman, Qatar) actions currently cost 2 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.

Can I call Bayut (UAE, Saudi Arabia, Jordan, Bahrain, Oman, Qatar) from an AI assistant or MCP client?▾

Yes. Connect ReefAPI once through MCP and your assistant can call bayut actions with the same key, credit pool and JSON envelope used by normal REST requests.

Same key

38 Real Estate APIs on the same key

One key, one credit pool, one response envelope. If you are pulling Bayut (UAE, Saudi Arabia, Jordan, Bahrain, Oman, Qatar), 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-19.