logo
API docs by Redocly

Bayut API (1.0)

Download OpenAPI specification:Download

Email: bayut.restapi@gmail.com URL: https://bayutapi.com Terms of Service

Bayut API is a property finder API that allows you to search for real estate properties in the UAE by scraping data from Bayut's Website (https://bayut.com).

You can gather data related to properties, agencies, agents, developers, amenities, transactions, etc…

Read more

Locations Search

Returns a list of locations (in UAE) for the given query.

  • Supports pagination via the page parameter.
  • Maximum results per page is 25.
query Parameters
query
required
string
Example: query=abu

The search query string to match against location names.

page
integer
Default: 0
Example: page=0

Page number for paginated results (starts from 0).

langs
string
Default: "en"
Example: langs=ar

Comma-separated list of preferred language codes (en, ar, ru, zh).

Responses

Response samples

Content type
application/json
{
  • "results": [
    ],
  • "count": 25,
  • "query": "abu",
  • "page": 0
}

Properties Search

Returns a list of real estate properties in UAE filtered by purpose, category, locations, price range, area, completion status, amenities, and more.

query Parameters
page
integer
Example: page=0

Page number for paginated results (starts from 0).

langs
string
Default: "en"
Example: langs=ar

Comma-separated list of preferred language codes (en, ar, ru, zh).

Request Body schema: application/json
purpose
string

Listing intent to filter properties (for-sale, for-rent).

category
string

Property category code to filter (residential, hotel-apartments, apartments, townhouses, villas, penthouse, villa-compound, residential-plots, residential-floors, residential-building, commercial, offices, shops, warehouses, labour-camps, commercial-villas, bulk-units, commercial-plots, commercial-floors, commercial-buildings, factories, industrial-land, mixed-use-land, showrooms, commercial-properties).

locations_ids
Array of integers

Comma-separated list of location IDs to filter properties by service areas.

index
string

Sort the result by popular, verified, latest, lowest_price, highest_price, projects.

is_completed
boolean

Flag to filter properties based on their completion status (under-construction or completed).

agent_id
integer

Agent's Unique identifier.

agency_id
integer

Agency's Unique identifier.

developer_id
integer

Developer's Unique identifier.

rooms
Array of integers

Allowed number of bedrooms.

baths
Array of integers

Allowed number of bathrooms.

is_furnished
boolean

Flag to filter properties based on furnishing status (true for furnished, false for unfurnished).

completion_percent_min
integer

Minimum completion percentage of the properties under construction (applicable when is_completed is false).

completion_percent_max
integer

Maximum completion percentage of the properties under construction (applicable when is_completed is false).

price_min
number <float>

Minimum property price in AED.

price_max
number <float>

Maximum property price in AED.

has_video
boolean

Flag to include (true) or exclude (false) properties with video tours. Don't use this parameter if it doesn't matter.

has_360_tour
boolean

Flag to include (true) or exclude (false) properties with 360° tours. Don't use this parameter if it doesn't matter.

has_floorplan
boolean

Flag to include (true) or exclude (false) properties with floor plans. Don't use this parameter if it doesn't matter.

amenities
Array of strings

List of desired amenities to filter properties.

area_min
number

Minimum area in sqft to filter properties.

area_max
number

Maximum area in sqft to filter properties.

completion_date
string <date>

Expected completion date (DD-MM-YYYY).

sale_type
string

Type of off-plan sale (any, new, resale, by_developer).

Responses

Request samples

Content type
application/json
{
  • "purpose": "for-sale",
  • "category": "apartments",
  • "locations_ids": [
    ],
  • "index": "popular",
  • "is_completed": false,
  • "agent_id": 2191615,
  • "agency_id": 10527,
  • "developer_id": 901,
  • "rooms": [
    ],
  • "baths": [
    ],
  • "is_furnished": false,
  • "completion_percent_min": 0,
  • "completion_percent_max": 90,
  • "price_min": 500000,
  • "price_max": 1000000,
  • "has_video": false,
  • "has_360_tour": false,
  • "has_floorplan": true,
  • "amenities": [
    ],
  • "area_min": 400,
  • "area_max": 1000,
  • "completion_date": "31-12-2027",
  • "sale_type": "any"
}

Response samples

Content type
application/json
{
  • "results": [
    ],
  • "count": 1,
  • "page": 0
}

Property Info

Fetch comprehensive details for a single property listing by its unique ID. Includes pricing, specifications, location hierarchy, agency and agent info, media assets, verification, legal data, project details, amenities, floor plans, payment plans, and so on.

path Parameters
id
required
integer
Example: 11761721

Property's unique identifier. (Get it from the property search results.)

query Parameters
langs
string
Example: langs=ar

Comma-separated list of language codes (en, ar, ru, zh).

Responses

Response samples

Content type
application/json
{
  • "id": 11761721,
  • "title": "Fully Furnished | Handover now | Great Layout",
  • "title_ar": "شقة في الصرح ريزيدنسز 11...",
  • "reference_number": "B-AS-136099",
  • "purpose": "for-sale",
  • "type": {
    },
  • "price": 1310000,
  • "area": {
    },
  • "details": {
    },
  • "description": "Property Listing: 1-Bedroom Apartment for Sale in Al Serh Residences 11...",
  • "description_ar": "عقارات: شقة من غرفة نوم واحدة للبيع في الصرح ريزيدنسز 11...",
  • "location": {
    },
  • "agency": {},
  • "agent": {
    },
  • "media": {},
  • "verification": {
    },
  • "legal": {
    },
  • "project": {
    },
  • "contact_methods": [
    ],
  • "meta": {
    },
  • "city_level_score": 3,
  • "indy_score": 528,
  • "location_purpose_tier": 1,
  • "score": 75,
  • "amenities": [
    ],
  • "floor_plan": {},
  • "payment_plans": [
    ],
  • "offplan_details": {
    },
  • "building_info": {
    }
}

Agencies by Locations

Returns a list of real estate agencies that operate in specified locations within the UAE.

Note: Agencies listed here may not be based in the location but have listed properties in that area.

query Parameters
locations_ids
required
string
Example: locations_ids=2,3

Comma-separated list of location IDs to filter agencies by service areas. Get these IDs from the "Locations Search" endpoint.

page
integer
Default: 0
Example: page=1

Pagination index (starting from 0).

langs
string
Default: "en"
Example: langs=ar

Comma-separated list of preferred language codes (en, ar, ru, zh).

Responses

Response samples

Content type
application/json
{
  • "results": [
    ],
  • "count": 25,
  • "locations_ids": [
    ],
  • "page": 1
}

Agencies by Name

Returns a list of real estate agencies whose names match the specified query string.

query Parameters
query
required
string
Example: query=k a

Search query for agency names.

page
integer
Default: 0
Example: page=1

Pagination index (starting from 0).

langs
string
Default: "en"
Example: langs=ar

Comma-separated list of preferred language codes (en, ar, ru, zh).

Responses

Response samples

Content type
application/json
{
  • "results": [
    ],
  • "count": 25,
  • "query": "k a",
  • "page": 1
}

Agency Info

Fetch comprehensive details for a single real estate agency by its unique ID. Includes description, contact information, licensing, activity statistics, and more.

path Parameters
id
required
integer
Example: 102062

Agency's unique identifier.

query Parameters
langs
string
Default: "en"
Example: langs=ru

Comma-separated list of language codes (en, ar, ru, zh).

Responses

Response samples

Content type
application/json
{
  • "id": 102062,
  • "name": "K A Homes Properties",
  • "name_ru": "K A Homes Properties",
  • "agents_count": 13,
  • "product": "featured",
  • "product_score": 1,
  • "logo": "https://bayut-production.s3.eu-central-1.amazonaws.com/image/346903261/4409eaeff3db4950b1c49fc63d5bece5",
  • "base_location": "Ajman",
  • "base_location_ru": "Аджман",
  • "slug": "k-a-homes-properties-102062",
  • "phone_numbers": {
    },
  • "contact_methods": [
    ],
  • "description": "An accredited, registered, and licensed real estate company established by K A HOMES\nAs a leading company in the United Arab Emirates with its renewed style in real estate activity in the field of marketing and selling real estate throughout the United Arab Emirates. The company has taken great strides in its endeavor to diversify its sales field by making customers one of its top priorities in its business and then proceeding to create services according to their needs.\n",
  • "description_ru": "An accredited, registered, and licensed real estate company established by K A HOMES\nAs a leading company in the United Arab Emirates with its renewed style in real estate activity in the field of marketing and selling real estate throughout the United Arab Emirates. The company has taken great strides in its endeavor to diversify its sales field by making customers one of its top priorities in its business and then proceeding to create services according to their needs.\n",
  • "is_featured": true,
  • "licenses": [
    ],
  • "base_locations": [
    ],
  • "stats": {
    }
}

Developers Search

Returns a list of real estate developers whose names match the given search query.

query Parameters
query
required
string
Example: query=ab

Search query to filter developer names.

page
integer
Default: 0
Example: page=0

Pagination index (starting from 0).

langs
string
Default: "en"
Example: langs=ar,ru

Comma-separated list of language codes (en, ar, ru, zh).

Responses

Response samples

Content type
application/json
{
  • "results": [
    ],
  • "count": 3,
  • "query": "ab",
  • "page": 0
}

Agents by Name

Returns a list of real estate agents whose names match the specified search query.

query Parameters
query
required
string
Example: query=vipul

Search query to filter agent names.

page
integer
Default: 0
Example: page=0

Pagination index (starting from 0).

langs
string
Default: "en"
Example: langs=ar

Comma-separated list of language codes (en, ar, ru, zh).

Responses

Response samples

Content type
application/json
{
  • "results": [
    ],
  • "count": 4,
  • "query": "vipul",
  • "page": 0
}

Agents by Filters

Get a list of real estate agents filtered by locations IDs, listing purpose, and property category.

query Parameters
locations_ids
string
Example: locations_ids=1

Comma-separated list of location IDs to filter agents by service areas.

purpose
string
Default: "for-sale"
Example: purpose=for-sale

Listing intent to filter agents (e.g., for-sale, for-rent).

category
string
Default: "residential"
Example: category=residential

Property category code to filter agents (e.g., residential, commercial, short_term_residential, long_term_residential).

page
integer
Default: 0
Example: page=0

Pagination index (starts from 0).

langs
string
Default: "en"
Example: langs=ar

Comma-separated list of language codes (en, ar, ru, zh).

Responses

Response samples

Content type
application/json
{
  • "results": [
    ],
  • "count": 25,
  • "locations_ids": [
    ],
  • "purpose": "for-sale",
  • "category": "residential"
}

Agents in Agency

Returns a list of all agents affiliated with a specific real estate agency in UAE.

Includes detailed profiles, contact information, performance statistics, and more.

path Parameters
agency_id
required
integer
Example: 102062

Agency's unique identifier whose agents will be listed.

query Parameters
langs
string
Default: "en"
Example: langs=ar

Comma-separated list of language codes (en, ar, ru, zh).

Responses

Response samples

Content type
application/json
{
  • "results": [
    ],
  • "count": 12
}

Agent Info

Returns information related to a single real estate agent by their unique ID.

Includes personal bio, experience, contact details, agency affiliation, performance statistics, and more.

path Parameters
id
required
integer
Example: 1852829

Unique identifier of the agent to retrieve.

query Parameters
langs
string
Default: "en"
Example: langs=ar

Comma-separated list of language codes (en, ar, ru, zh).

Responses

Response samples

Content type
application/json
{
  • "id": 1852829,
  • "name": "Vishnu Vinod",
  • "name_ar": "Vishnu Vinod",
  • "about_user": "I am a highly knowledgeable and reliable professional in the real estate industry, particularly in the short term rental sector. I understand the importance of providing quality services and focuses on having a comprehensive understanding of the areas and projects I deals with. By prioritizing quality over quantity, I stay up-to-date with the latest trends, market conditions, and legal requirements in the real estate industry. This enables me to offer reliable advice that aligns with my clients' goals and needs. With my commitment to honesty, customer service, and expertise, I can be a trusted partner in your search for a home or investment property\n",
  • "about_user_ar": "I am a highly knowledgeable and reliable professional in the real estate industry, particularly in the short term rental sector. I understand the importance of providing quality services and focuses on having a comprehensive understanding of the areas and projects I deals with. By prioritizing quality over quantity, I stay up-to-date with the latest trends, market conditions, and legal requirements in the real estate industry. This enables me to offer reliable advice that aligns with my clients' goals and needs. With my commitment to honesty, customer service, and expertise, I can be a trusted partner in your search for a home or investment property\n",
  • "user_image": "https://bayut-production.s3.eu-central-1.amazonaws.com/image/587528669/dcb52a50d8cc4dfa845f3d59664b4ab7",
  • "experience": 3,
  • "home_country": "UnitedArabEmirates",
  • "home_country_ar": "الإمارات",
  • "agency": {},
  • "avg_star_rating": 4,
  • "contact_methods": [
    ],
  • "phone_numbers": {
    },
  • "social_media": {},
  • "stats": {
    },
  • "slug": "vishnu-vinod-1852829",
  • "brn_number": "",
  • "bln_number": "",
  • "service_areas": [
    ],
  • "service_areas_ar": [
    ],
  • "specialities": [
    ],
  • "specialities_ar": [
    ],
  • "user_langs": [
    ],
  • "user_langs_ar": [
    ],
  • "state": "active",
  • "is_tru_broker": false,
  • "total_xp": 7335,
  • "is_highly_responsive": true,
  • "is_quality_lister": true,
  • "has_badges": true,
  • "active_in_emirate": "Dubai",
  • "is_profile_completed": true,
  • "is_complete": true,
  • "top_agent": false,
  • "leaderboard_filters": {
    }
}

Transactions

Fetch Dubai's Real Estate Transactions based on custom filters like location, category, price, area, date range, and more.

query Parameters
page
integer
Example: page=0

Pagination index (starting from 0).

Request Body schema: application/json
purpose
string

Transaction purpose (for-sale, for-rent).

locations_ids
Array of integers

List of location IDs to filter by. (Must belong to Dubai)

category
string

Property category code to filter (residential,commercial,villas,apartments, offices,shops,warehouses,factories,labour-camp,commercial-buildings,commercial-properties, residential-plots,commercial-plots,townhouses,residential-building,penthouse,hotel-apartments, industrial-land,mixed-use-land,showrooms,commercial-villas).

completion_status
string

Construction status (completed, under-construction).

contract_type
string

Type of contract (Renewal, New, All).

sort_by
string

Field by which to sort the results (e.g., date, amount, rent, builtup_area, plot_area, beds, duration).

order
string

Sort order (asc for ascending or desc for descending).

beds
Array of integers

Allowed number of bedrooms.

area_min
integer

Minimum area in sqft.

area_max
integer

Maximum area in sqft.

price_min
integer

Minimum price in AED.

price_max
integer

Maximum price in AED.

start_date
string <date>

Start date for filtering transactions (inclusive).

end_date
string <date>

End date for filtering transactions (inclusive).

time_frame
string

Time frame for aggregation (1m,3m,6m,12m,36m).

Responses

Request samples

Content type
application/json
{
  • "purpose": "for-sale",
  • "locations_ids": [
    ],
  • "category": "residential",
  • "completion_status": "completed",
  • "contract_type": "All",
  • "sort_by": "date",
  • "order": "desc",
  • "beds": [
    ],
  • "area_min": 0,
  • "area_max": 1000000,
  • "price_min": 0,
  • "price_max": 1000000,
  • "start_date": "2024-01-01",
  • "end_date": "2025-01-01",
  • "time_frame": "12m"
}

Response samples

Content type
application/json
{
  • "results": [
    ],
  • "count": 20,
  • "page": 0
}

Amenities Search

Returns a list of amenities that match the search query.

query Parameters
query
required
string
Example: query=air

Search term for filtering amenities

Responses

Response samples

Content type
application/json
{
  • "results": [
    ],
  • "count": 2,
  • "query": "air"
}