Bayut (UAE, Saudi Arabia, Jordan, Bahrain, Oman, Qatar)
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.
/bayut/v1/locations2 creditsBayut's own location search box: emirates / cities, communities, sub-communities and buildings that match a name, with the id every other action accepts, the full path, coordinates and the site's live listing count.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | required | — | Place or building name (or the start of it). |
| country = ae | optional | ae · sa · jo · bh · om · qa | Which Bayut portal: ae = bayut.com (UAE, default), sa = bayut.sa, jo = bayut.jo, bh = bayut.bh, om = bayut.om, qa = bayut.qa. |
| language = en | optional | en · ar · ru | Language of the names, titles and descriptions: en (default), ar; ru on bayut.com. |
| type | optional | — | Only this kind of place, as the site types them: neighbourhood, condo-building, cluster, villa-community, … (unset = all). |
| page = 1 | optional | 1–50000 | Result page, 1-based. page × limit may not pass 50,000 (the site's own search window). |
| limit = 10 | optional | 1–100 | Rows per page, 1-100. |
/bayut/v1/search2 creditsSearch Bayut listings for sale or for rent with every filter and sort the site's own search sends (location, property type, price, bedrooms, bathrooms, area, rent period, furnishing, ready / off-plan, off-plan sale type, TruCheck verified, TruBroker agent, video / 360 tour / floor plan, amenities, agency, agent, developer, posting date, keyword, radius), paged with the site's total. Each row carries the price, size, full location path, coordinates, photos, verification, the agent and the agency with phone and WhatsApp.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| country = ae | optional | ae · sa · jo · bh · om · qa | Which Bayut portal: ae = bayut.com (UAE, default), sa = bayut.sa, jo = bayut.jo, bh = bayut.bh, om = bayut.om, qa = bayut.qa. |
| language = en | optional | en · ar · ru | Language of the names, titles and descriptions: en (default), ar; ru on bayut.com. |
| purpose = for_sale | optional | for_sale · for_rent | for_sale (default) or for_rent. `sale`, `buy`, `rent` are accepted too. |
| location | optional | — | Place name, slug or id (emirate / city, community, sub-community, building). A name is resolved with the site's own location search and the match is echoed in `location_match`; an unknown name is refused with suggestions. |
| location_ids | optional | — | One or more Bayut location ids from `locations` (comma-separated, matched as OR). |
| category | optional | residential · apartments · villas · townhouses · penthouse · hotel-apartments · villa-compound · residential-plots · residential-floors · residential-building · commercial · offices · shops · warehouses · labour-camps · bulk-units · commercial-plots · commercial-floors · commercial-buildings · factories · industrial-land · mixed-use-land · showrooms · commercial-villas | Property type slug(s), comma-separated (OR): residential, apartments, villas, townhouses, penthouse, hotel-apartments, offices, shops, warehouses, … (list below). The sister portals use their own slugs (bayut.sa: apartments, villas, lands …). |
| query | optional | — | Free-text keywords matched by the site's own search (title, location, …). |
| price_min | optional | 0– | Lowest price in the portal's currency (AED on bayut.com). |
| price_max | optional | 0– | Highest price in the portal's currency. |
| bedrooms | optional | — | Bedroom counts, comma-separated (OR): studio, 1, 2 … and N+ (e.g. 7+). |
| bedrooms_min | optional | 0–50 | At least this many bedrooms (0 = studio). |
| bedrooms_max | optional | 0–50 | At most this many bedrooms. |
| bathrooms | optional | — | Bathroom counts, comma-separated (OR): 1, 2 … and N+ (e.g. 6+). |
| bathrooms_min | optional | 0–50 | At least this many bathrooms. |
| bathrooms_max | optional | 0–50 | At most this many bathrooms. |
| area_min | optional | 0– | Smallest built-up area in square FEET (the unit the site shows). |
| area_max | optional | 0– | Largest built-up area in square feet. |
| rent_frequency | optional | yearly · monthly · weekly · daily | Rentals only: yearly, monthly, weekly or daily. Unset = every period (the site's own rent page pre-selects yearly). |
| furnishing | optional | furnished · unfurnished | furnished or unfurnished. |
| completion_status | optional | ready · off_plan | ready or off_plan. |
| sale_type | optional | new · resale | Off-plan listings: new (from the developer) or resale. |
| verified | optional | — | true = only TruCheck™ verified listings. |
| trubroker | optional | — | true = only listings whose agent holds the TruBroker™ badge. |
| has_video | optional | — | true = only listings with a video. |
| has_360_tour | optional | — | true = only listings with a 360° tour. |
| has_floor_plan | optional | — | true = only listings with a floor plan. |
| amenities | optional | — | Amenities that must all be present, comma-separated, as the site names them (e.g. swimming pool, balcony or terrace, covered parking). |
| agency_id | optional | — | Only listings of this agency (id from `agencies`). |
| agent_id | optional | — | Only listings of this agent (id from `agents`). |
| developer_id | optional | — | Only listings in projects of this developer (agency id of type developer). |
| posted_within_days | optional | 1–3650 | Only listings first posted in the last N days. |
| latitude | optional | — | Centre latitude for a radius search. |
| longitude | optional | — | Centre longitude for a radius search. |
| radius_km | optional | 0.1–200 | Radius around latitude/longitude in km. |
| sort = popular | optional | popular · newest · price_asc · price_desc · verified | Result order. |
| page = 1 | optional | 1–50000 | Result page, 1-based. page × limit may not pass 50,000 (the site's own search window). |
| limit = 25 | optional | 1–100 | Rows per page, 1-100 (the site's own page shows 24). |
/bayut/v1/count2 creditsHow many live listings match a search (same filters as `search`, no rows): the site's own count for a market slice, e.g. 2-bedroom apartments for rent in Dubai Marina under AED 150,000.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| country = ae | optional | ae · sa · jo · bh · om · qa | Which Bayut portal: ae = bayut.com (UAE, default), sa = bayut.sa, jo = bayut.jo, bh = bayut.bh, om = bayut.om, qa = bayut.qa. |
| purpose = for_sale | optional | for_sale · for_rent | for_sale (default) or for_rent. `sale`, `buy`, `rent` are accepted too. |
| location | optional | — | Place name, slug or id (emirate / city, community, sub-community, building). A name is resolved with the site's own location search and the match is echoed in `location_match`; an unknown name is refused with suggestions. |
| location_ids | optional | — | One or more Bayut location ids from `locations` (comma-separated, matched as OR). |
| category | optional | residential · apartments · villas · townhouses · penthouse · hotel-apartments · villa-compound · residential-plots · residential-floors · residential-building · commercial · offices · shops · warehouses · labour-camps · bulk-units · commercial-plots · commercial-floors · commercial-buildings · factories · industrial-land · mixed-use-land · showrooms · commercial-villas | Property type slug(s), comma-separated (OR): residential, apartments, villas, townhouses, penthouse, hotel-apartments, offices, shops, warehouses, … (list below). The sister portals use their own slugs (bayut.sa: apartments, villas, lands …). |
| query | optional | — | Free-text keywords matched by the site's own search (title, location, …). |
| price_min | optional | 0– | Lowest price in the portal's currency (AED on bayut.com). |
| price_max | optional | 0– | Highest price in the portal's currency. |
| bedrooms | optional | — | Bedroom counts, comma-separated (OR): studio, 1, 2 … and N+ (e.g. 7+). |
| bedrooms_min | optional | 0–50 | At least this many bedrooms (0 = studio). |
| bedrooms_max | optional | 0–50 | At most this many bedrooms. |
| bathrooms | optional | — | Bathroom counts, comma-separated (OR): 1, 2 … and N+ (e.g. 6+). |
| bathrooms_min | optional | 0–50 | At least this many bathrooms. |
| bathrooms_max | optional | 0–50 | At most this many bathrooms. |
| area_min | optional | 0– | Smallest built-up area in square FEET (the unit the site shows). |
| area_max | optional | 0– | Largest built-up area in square feet. |
| rent_frequency | optional | yearly · monthly · weekly · daily | Rentals only: yearly, monthly, weekly or daily. Unset = every period (the site's own rent page pre-selects yearly). |
| furnishing | optional | furnished · unfurnished | furnished or unfurnished. |
| completion_status | optional | ready · off_plan | ready or off_plan. |
| sale_type | optional | new · resale | Off-plan listings: new (from the developer) or resale. |
| verified | optional | — | true = only TruCheck™ verified listings. |
| trubroker | optional | — | true = only listings whose agent holds the TruBroker™ badge. |
| has_video | optional | — | true = only listings with a video. |
| has_360_tour | optional | — | true = only listings with a 360° tour. |
| has_floor_plan | optional | — | true = only listings with a floor plan. |
| amenities | optional | — | Amenities that must all be present, comma-separated, as the site names them (e.g. swimming pool, balcony or terrace, covered parking). |
| agency_id | optional | — | Only listings of this agency (id from `agencies`). |
| agent_id | optional | — | Only listings of this agent (id from `agents`). |
| developer_id | optional | — | Only listings in projects of this developer (agency id of type developer). |
| posted_within_days | optional | 1–3650 | Only listings first posted in the last N days. |
| latitude | optional | — | Centre latitude for a radius search. |
| longitude | optional | — | Centre longitude for a radius search. |
| radius_km | optional | 0.1–200 | Radius around latitude/longitude in km. |
/bayut/v1/listing2 creditsEverything one listing page shows: price, rent period, size and plot size, rooms, furnishing, completion and handover, the full description, every photo, the floor plan (2D / 3D), videos and 360 tours, amenities by group, the payment plan and off-plan details, TruCheck verification, the agent (BRN, experience, mobile, WhatsApp, e-mail, languages) and the agency with its RERA / ORN licence numbers.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| listing_id | required | — | Bayut listing id or the listing link. |
| country = ae | optional | ae · sa · jo · bh · om · qa | Which Bayut portal: ae = bayut.com (UAE, default), sa = bayut.sa, jo = bayut.jo, bh = bayut.bh, om = bayut.om, qa = bayut.qa. |
| language = en | optional | en · ar · ru | Language of the names, titles and descriptions: en (default), ar; ru on bayut.com. |
/bayut/v1/listings2 creditsUp to 50 listings by id in ONE upstream request (the site's own search index), e.g. to refresh prices and status of listings you already track. Rows are the `search` rows (no description); ids that are no longer live come back in `missing_ids`.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| listing_ids | required | — | 1-50 listing ids, comma-separated. |
| country = ae | optional | ae · sa · jo · bh · om · qa | Which Bayut portal: ae = bayut.com (UAE, default), sa = bayut.sa, jo = bayut.jo, bh = bayut.bh, om = bayut.om, qa = bayut.qa. |
| language = en | optional | en · ar · ru | Language of the names, titles and descriptions: en (default), ar; ru on bayut.com. |
/bayut/v1/projects2 creditsNew projects (off-plan and recently completed) as the site's new-projects search lists them: developer, location, unit types, starting price, completion date and progress, payment plan, amenities and the number of live listings in each.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| country = ae | optional | ae · sa · jo · bh · om · qa | Which Bayut portal: ae = bayut.com (UAE, default), sa = bayut.sa, jo = bayut.jo, bh = bayut.bh, om = bayut.om, qa = bayut.qa. |
| language = en | optional | en · ar · ru | Language of the names, titles and descriptions: en (default), ar; ru on bayut.com. |
| query | optional | — | Project name words. |
| location | optional | — | Place name, slug or id. |
| location_ids | optional | — | Bayut location ids (OR). |
| developer_id | optional | — | Developer id (an `agencies` row of type developer). |
| completion_status | optional | ready · off_plan | ready or off_plan. |
| page = 1 | optional | 1–50000 | Result page, 1-based. page × limit may not pass 50,000 (the site's own search window). |
| limit = 25 | optional | 1–100 | Rows per page, 1-100 (the site's own page shows 24). |
/bayut/v1/project2 creditsOne new project: developer, location, unit types and bedroom mix, starting price, completion date and progress, payment plan, amenities, description, photos, documents and its live listing count.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| project_id | required | — | Project id from `projects` (or a listing's project.id). |
| country = ae | optional | ae · sa · jo · bh · om · qa | Which Bayut portal: ae = bayut.com (UAE, default), sa = bayut.sa, jo = bayut.jo, bh = bayut.bh, om = bayut.om, qa = bayut.qa. |
| language = en | optional | en · ar · ru | Language of the names, titles and descriptions: en (default), ar; ru on bayut.com. |
/bayut/v1/agents2 creditsSearch Bayut's agent directory (bayut.com and bayut.sa) by name, area, emirate, spoken language, speciality, agency or TruBroker badge: e-mail, mobile, WhatsApp, agency, badges and listing counts.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| country = ae | optional | ae · sa · jo · bh · om · qa | Which Bayut portal: ae = bayut.com (UAE, default), sa = bayut.sa, jo = bayut.jo, bh = bayut.bh, om = bayut.om, qa = bayut.qa. |
| language = en | optional | en · ar · ru | Language of the names, titles and descriptions: en (default), ar; ru on bayut.com. |
| query | optional | — | Agent name words. |
| location | optional | — | Only agents with live listings in this place (name, slug or id). |
| emirate | optional | Dubai · Abu Dhabi | Only agents active in this emirate (bayut.com). |
| spoken_language | optional | — | Language code the agent speaks (en, ar, hi, ur, ru, fr, …). |
| speciality | optional | residential_sales · residential_leasing · commercial_sales · commercial_leasing · off_plan_sales | Only agents with this speciality. |
| agency_id | optional | — | Only agents of this agency. |
| trubroker | optional | — | true = TruBroker™ agents only. |
| page = 1 | optional | 1–50000 | Result page, 1-based. page × limit may not pass 50,000 (the site's own search window). |
| limit = 25 | optional | 1–100 | Rows per page, 1-100 (the site's own page shows 24). |
/bayut/v1/agent2 creditsOne agent's profile as the broker page shows it: BRN, years of experience, nationality, e-mail, mobile, WhatsApp, languages, specialities, service areas, badges, listing counts and the agency with its licences.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| agent_id | required | — | Agent id, slug or bayut.com/brokers/… link. |
| country = ae | optional | ae · sa · jo · bh · om · qa | Which Bayut portal: ae = bayut.com (UAE, default), sa = bayut.sa, jo = bayut.jo, bh = bayut.bh, om = bayut.om, qa = bayut.qa. |
| language = en | optional | en · ar · ru | Language of the names, titles and descriptions: en (default), ar; ru on bayut.com. |
/bayut/v1/agent_listings2 creditsOne agent's live listings, with the same filters and sorts as `search`.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| agent_id | required | — | Agent id, slug or link. |
| country = ae | optional | ae · sa · jo · bh · om · qa | Which Bayut portal: ae = bayut.com (UAE, default), sa = bayut.sa, jo = bayut.jo, bh = bayut.bh, om = bayut.om, qa = bayut.qa. |
| language = en | optional | en · ar · ru | Language of the names, titles and descriptions: en (default), ar; ru on bayut.com. |
| purpose | optional | for_sale · for_rent | for_sale (default) or for_rent. `sale`, `buy`, `rent` are accepted too. |
| location | optional | — | Place name, slug or id (emirate / city, community, sub-community, building). A name is resolved with the site's own location search and the match is echoed in `location_match`; an unknown name is refused with suggestions. |
| location_ids | optional | — | One or more Bayut location ids from `locations` (comma-separated, matched as OR). |
| category | optional | residential · apartments · villas · townhouses · penthouse · hotel-apartments · villa-compound · residential-plots · residential-floors · residential-building · commercial · offices · shops · warehouses · labour-camps · bulk-units · commercial-plots · commercial-floors · commercial-buildings · factories · industrial-land · mixed-use-land · showrooms · commercial-villas | Property type slug(s), comma-separated (OR): residential, apartments, villas, townhouses, penthouse, hotel-apartments, offices, shops, warehouses, … (list below). The sister portals use their own slugs (bayut.sa: apartments, villas, lands …). |
| query | optional | — | Free-text keywords matched by the site's own search (title, location, …). |
| price_min | optional | 0– | Lowest price in the portal's currency (AED on bayut.com). |
| price_max | optional | 0– | Highest price in the portal's currency. |
| bedrooms | optional | — | Bedroom counts, comma-separated (OR): studio, 1, 2 … and N+ (e.g. 7+). |
| bedrooms_min | optional | 0–50 | At least this many bedrooms (0 = studio). |
| bedrooms_max | optional | 0–50 | At most this many bedrooms. |
| bathrooms | optional | — | Bathroom counts, comma-separated (OR): 1, 2 … and N+ (e.g. 6+). |
| bathrooms_min | optional | 0–50 | At least this many bathrooms. |
| bathrooms_max | optional | 0–50 | At most this many bathrooms. |
| area_min | optional | 0– | Smallest built-up area in square FEET (the unit the site shows). |
| area_max | optional | 0– | Largest built-up area in square feet. |
| rent_frequency | optional | yearly · monthly · weekly · daily | Rentals only: yearly, monthly, weekly or daily. Unset = every period (the site's own rent page pre-selects yearly). |
| furnishing | optional | furnished · unfurnished | furnished or unfurnished. |
| completion_status | optional | ready · off_plan | ready or off_plan. |
| sale_type | optional | new · resale | Off-plan listings: new (from the developer) or resale. |
| verified | optional | — | true = only TruCheck™ verified listings. |
| trubroker | optional | — | true = only listings whose agent holds the TruBroker™ badge. |
| has_video | optional | — | true = only listings with a video. |
| has_360_tour | optional | — | true = only listings with a 360° tour. |
| has_floor_plan | optional | — | true = only listings with a floor plan. |
| amenities | optional | — | Amenities that must all be present, comma-separated, as the site names them (e.g. swimming pool, balcony or terrace, covered parking). |
| agency_id | optional | — | Only listings of this agency (id from `agencies`). |
| developer_id | optional | — | Only listings in projects of this developer (agency id of type developer). |
| posted_within_days | optional | 1–3650 | Only listings first posted in the last N days. |
| latitude | optional | — | Centre latitude for a radius search. |
| longitude | optional | — | Centre longitude for a radius search. |
| radius_km | optional | 0.1–200 | Radius around latitude/longitude in km. |
| sort = popular | optional | popular · newest · price_asc · price_desc · verified | Result order. |
| page = 1 | optional | 1–50000 | Result page, 1-based. page × limit may not pass 50,000 (the site's own search window). |
| limit = 25 | optional | 1–100 | Rows per page, 1-100 (the site's own page shows 24). |
/bayut/v1/agencies2 creditsSearch Bayut's agency directory — brokerages, or developers with type=developer — by name and area: RERA / ORN licences, phones, agent counts and live listing counts.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| country = ae | optional | ae · sa · jo · bh · om · qa | Which Bayut portal: ae = bayut.com (UAE, default), sa = bayut.sa, jo = bayut.jo, bh = bayut.bh, om = bayut.om, qa = bayut.qa. |
| language = en | optional | en · ar · ru | Language of the names, titles and descriptions: en (default), ar; ru on bayut.com. |
| query | optional | — | Agency name words. |
| type | optional | agency · developer | agency or developer (unset = both). |
| location | optional | — | Only agencies with live listings in this place. |
| page = 1 | optional | 1–50000 | Result page, 1-based. page × limit may not pass 50,000 (the site's own search window). |
| limit = 25 | optional | 1–100 | Rows per page, 1-100 (the site's own page shows 24). |
/bayut/v1/agency2 creditsOne agency's profile: description, RERA / ORN licences, phones, agent and TruBroker counts, live listing counts, service areas, property types and languages. Developers return their directory record (the site has no company page for them).
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| agency_id | required | — | Agency id, slug or bayut.com/companies/… link. |
| country = ae | optional | ae · sa · jo · bh · om · qa | Which Bayut portal: ae = bayut.com (UAE, default), sa = bayut.sa, jo = bayut.jo, bh = bayut.bh, om = bayut.om, qa = bayut.qa. |
| language = en | optional | en · ar · ru | Language of the names, titles and descriptions: en (default), ar; ru on bayut.com. |
/bayut/v1/agency_agents2 creditsEvery agent of one agency with e-mail, mobile, WhatsApp, languages, badges and listing counts.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| agency_id | required | — | Agency id or slug. |
| country = ae | optional | ae · sa · jo · bh · om · qa | Which Bayut portal: ae = bayut.com (UAE, default), sa = bayut.sa, jo = bayut.jo, bh = bayut.bh, om = bayut.om, qa = bayut.qa. |
| language = en | optional | en · ar · ru | Language of the names, titles and descriptions: en (default), ar; ru on bayut.com. |
| page = 1 | optional | 1–50000 | Result page, 1-based. page × limit may not pass 50,000 (the site's own search window). |
| limit = 25 | optional | 1–100 | Rows per page, 1-100 (the site's own page shows 24). |
/bayut/v1/agency_listings2 creditsOne agency's live listings, with the same filters and sorts as `search`.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| agency_id | required | — | Agency id or slug. |
| country = ae | optional | ae · sa · jo · bh · om · qa | Which Bayut portal: ae = bayut.com (UAE, default), sa = bayut.sa, jo = bayut.jo, bh = bayut.bh, om = bayut.om, qa = bayut.qa. |
| language = en | optional | en · ar · ru | Language of the names, titles and descriptions: en (default), ar; ru on bayut.com. |
| purpose | optional | for_sale · for_rent | for_sale (default) or for_rent. `sale`, `buy`, `rent` are accepted too. |
| location | optional | — | Place name, slug or id (emirate / city, community, sub-community, building). A name is resolved with the site's own location search and the match is echoed in `location_match`; an unknown name is refused with suggestions. |
| location_ids | optional | — | One or more Bayut location ids from `locations` (comma-separated, matched as OR). |
| category | optional | residential · apartments · villas · townhouses · penthouse · hotel-apartments · villa-compound · residential-plots · residential-floors · residential-building · commercial · offices · shops · warehouses · labour-camps · bulk-units · commercial-plots · commercial-floors · commercial-buildings · factories · industrial-land · mixed-use-land · showrooms · commercial-villas | Property type slug(s), comma-separated (OR): residential, apartments, villas, townhouses, penthouse, hotel-apartments, offices, shops, warehouses, … (list below). The sister portals use their own slugs (bayut.sa: apartments, villas, lands …). |
| query | optional | — | Free-text keywords matched by the site's own search (title, location, …). |
| price_min | optional | 0– | Lowest price in the portal's currency (AED on bayut.com). |
| price_max | optional | 0– | Highest price in the portal's currency. |
| bedrooms | optional | — | Bedroom counts, comma-separated (OR): studio, 1, 2 … and N+ (e.g. 7+). |
| bedrooms_min | optional | 0–50 | At least this many bedrooms (0 = studio). |
| bedrooms_max | optional | 0–50 | At most this many bedrooms. |
| bathrooms | optional | — | Bathroom counts, comma-separated (OR): 1, 2 … and N+ (e.g. 6+). |
| bathrooms_min | optional | 0–50 | At least this many bathrooms. |
| bathrooms_max | optional | 0–50 | At most this many bathrooms. |
| area_min | optional | 0– | Smallest built-up area in square FEET (the unit the site shows). |
| area_max | optional | 0– | Largest built-up area in square feet. |
| rent_frequency | optional | yearly · monthly · weekly · daily | Rentals only: yearly, monthly, weekly or daily. Unset = every period (the site's own rent page pre-selects yearly). |
| furnishing | optional | furnished · unfurnished | furnished or unfurnished. |
| completion_status | optional | ready · off_plan | ready or off_plan. |
| sale_type | optional | new · resale | Off-plan listings: new (from the developer) or resale. |
| verified | optional | — | true = only TruCheck™ verified listings. |
| trubroker | optional | — | true = only listings whose agent holds the TruBroker™ badge. |
| has_video | optional | — | true = only listings with a video. |
| has_360_tour | optional | — | true = only listings with a 360° tour. |
| has_floor_plan | optional | — | true = only listings with a floor plan. |
| amenities | optional | — | Amenities that must all be present, comma-separated, as the site names them (e.g. swimming pool, balcony or terrace, covered parking). |
| agent_id | optional | — | Only listings of this agent (id from `agents`). |
| developer_id | optional | — | Only listings in projects of this developer (agency id of type developer). |
| posted_within_days | optional | 1–3650 | Only listings first posted in the last N days. |
| latitude | optional | — | Centre latitude for a radius search. |
| longitude | optional | — | Centre longitude for a radius search. |
| radius_km | optional | 0.1–200 | Radius around latitude/longitude in km. |
| sort = popular | optional | popular · newest · price_asc · price_desc · verified | Result order. |
| page = 1 | optional | 1–50000 | Result page, 1-based. page × limit may not pass 50,000 (the site's own search window). |
| limit = 25 | optional | 1–100 | Rows per page, 1-100 (the site's own page shows 24). |
curl -X POST https://api.reefapi.com/bayut/v1/locations \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"Dubai Marina"}'{
"ok": true,
"data": { /* the result */ },
"meta": {
"latency_ms": 240,
"record_count": 12,
"completeness_pct": 100
},
"error": null
}Measured at 60 requests a second across the fleet, with no central bottleneck. Volume pricing is on request, and per-key limits are raised for high-volume accounts.
Tell us a site we do not cover yet and it becomes an engine. A customer asked for bestprice.gr on a Sunday and it was in the catalog the next day.
Median time from a question in the live chat to the first answer, measured across every answered conversation. Setup help included, no support tier to buy.
No per-site plans and no separate subscriptions. One key and one credit pool across the whole catalog, so adding a source costs nothing up front.
Planning something large? Tell us the volume and the sources and we will come back with what it costs and what we would have to build.