Happy Endpoint

Search properties for sale or rent

Search properties available for sale or rent in Dubai/UAE. Filter by location, property type, bedrooms, bathrooms, price range, area, amenities, completion status, and more. Supports multiple sort orders and multi-language results.

GET
/search-property

Authorization

RapidApiKey
X-RapidAPI-Key<token>

In: header

Query Parameters

purpose*string
  • Transaction type
  • for-sale — properties for purchase
  • for-rent — properties for rent
Value in"for-sale" | "for-rent"
page?integer
  • Page number (starts from 1)
  • Results per page: 24
Default1
Range1 <= value
langs?string
  • Comma-separated language codes
  • Available: en, ar, ru, zh
  • Example: en,ar returns English + Arabic
  • Default: en
Default"en"
location_ids?string
  • Comma-separated location external IDs
  • Get IDs from /autocomplete endpoint (externalID field)
property_type?string
  • Comma-separated property types
  • Use residential or commercial to search all sub-types
  • Residential types: apartments, townhouses, penthouse, villas, villa-compound, hotel-apartments, residential-plots, residential-floors, residential-building
  • Commercial types: offices, warehouses, commercial-villas, commercial-plots, commercial-buildings, industrial-land, showrooms, shops, labour-camps, bulk-units, commercial-floors, factories, mixed-use-land, commerical-properties
sort_order?string
  • Sort order for results
  • popular — most popular (default)
  • latest — newest listings
  • verified — TruCheck verified first
  • trubroker_first — TruBroker agents first
  • lowest_price — cheapest first
  • highest_price — most expensive first
Default"popular"
Value in"popular" | "latest" | "verified" | "trubroker_first" | "lowest_price" | "highest_price"
completion_status?string
  • Filter by completion status
  • completed — ready/built properties
  • under-construction — off-plan/under construction
  • any — all properties (omit this param for no filter)
Value in"completed" | "under-construction" | "any"
rooms?string
  • Comma-separated number of bedrooms
  • 0 = Studio
  • Example: 0,1,2 for studio, 1-bed, 2-bed
baths?string
  • Comma-separated number of bathrooms
  • Example: 1,2,3
is_furnished?string
  • Filter by furnishing status
  • furnished — furnished properties
  • unfurnished — unfurnished properties
Value in"furnished" | "unfurnished"
price_min?integer
  • Minimum price in AED
  • For sale: purchase price
  • For rent: annual rent amount
  • For Buy Transaction: 200000, 225000, 250000
  • For Rent Transaction: 20000, 30000, 40000
Range0 <= value
price_max?integer
  • Maximum price in AED
  • For sale: purchase price
  • For rent: annual rent amount
  • For Buy Transaction: 400000, 450000, 500000
  • For Rent Transaction: 50000, 50000, 85000
Range0 <= value
area_min?number
  • Minimum area in Square Feet (sqft)
  • For Buy Transactions: 800, 1000, 1500, 2000`
  • For Rent Transactions: 800, 1000, 1500, 2000`
Range0 <= value
area_max?number
  • Maximum area in Square Feet (sqft)
Range0 <= value
amenities?string
  • Comma-separated amenity names
  • Use /amenities-search endpoint to find available amenities
  • Examples: Swimming Pool, Security Staff, Gym, Parking
has_video?boolean
  • Filter properties that have video tours
has_360_tour?boolean
  • Filter properties that have 360° virtual tours
has_floorplan?boolean
  • Filter properties that have floor plans
agent_ids?string
  • Comma-separated agent IDs to filter by specific agents
  • Examples: 474947, 632216
agency_ids?string
  • Comma-separated agency external IDs to filter by specific agencies
  • Examples:- 10212, 6168, 6415
developer_ids?string
  • Comma-separated developer IDs to filter by specific developers
rent_frequency?string
  • Rent payment frequency (only for for-rent purpose)
  • Default: yearly
  • Options: yearly, monthly, weekly, daily
Value in"yearly" | "monthly" | "weekly" | "daily"

Header Parameters

X-RapidAPI-Host*string
Default"bayut14.p.rapidapi.com"

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/search-property?purpose=for-sale" \  -H "X-RapidAPI-Host: bayut14.p.rapidapi.com"
{
  "success": true,
  "data": {
    "properties": [
      {
        "id": "10283980",
        "externalID": "10283980",
        "title": {
          "en": "2BR Apartment in Dubai Marina"
        },
        "description": {
          "property1": "string",
          "property2": "string"
        },
        "slug": {
          "property1": "string",
          "property2": "string"
        },
        "purpose": "for-sale",
        "price": 1500000,
        "rentFrequency": "string",
        "rooms": 2,
        "baths": 3,
        "area": 120.5,
        "coverPhoto": null,
        "photoCount": 15,
        "videoCount": 1,
        "panoramaCount": 0,
        "location": null,
        "category": null,
        "agency": null,
        "contactName": "John Smith",
        "phoneNumber": null,
        "referenceNumber": "REF-12345",
        "isVerified": true,
        "completionStatus": "completed",
        "furnishingStatus": "furnished",
        "createdAt": 0,
        "updatedAt": 0,
        "ownerAgent": null,
        "floorPlanID": 0,
        "geography": null,
        "amenities": null,
        "offplanDetails": null,
        "project": null
      }
    ],
    "total": 1250,
    "page": 1,
    "totalPages": 53,
    "hitsPerPage": 24
  }
}
{
  "success": false,
  "message": "Invalid request: Missing required parameter",
  "error": "VALIDATION_ERROR"
}
{
  "success": false,
  "message": "Internal server error. Please try again later.",
  "error": "INTERNAL_ERROR"
}
{
  "success": false,
  "message": "Service temporarily unavailable. Please try again later.",
  "error": "API_ERROR"
}