Happy Endpoint

Search new off-plan development projects

Search for new development projects and off-plan properties in Dubai/UAE. These are properties with floor plans that are under construction or newly launched.

GET
/search-new-projects

Authorization

RapidApiKey
X-RapidAPI-Key<token>

In: header

Query Parameters

location_ids?string
  • Comma-separated location external IDs
page?integer
  • Page number (starts from 1)
  • Results per page: 24
Default1
Range1 <= value
langs?string
  • Comma-separated language codes: en, ar, ru, zh
Default"en"
property_type?string
  • Comma-separated property types
  • Default: residential
  • 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
Default"popular"
Value in"popular" | "latest" | "verified" | "trubroker_first" | "lowest_price" | "highest_price"
price_min?integer
  • Minimum price in AED
Range0 <= value
price_max?integer
  • Maximum price in AED
Range0 <= value
area_min?number
  • Minimum area in sqft
Range0 <= value
area_max?number
  • Maximum area in sqft
Range0 <= value
rooms?string
  • Comma-separated bedrooms (0=Studio)
baths?string
  • Comma-separated bathrooms
developer_ids?string
  • Comma-separated developer IDs
  • Get developer's id from /developer-search-by-name endpoint
  • i.e. - 551 for "Sobha Realty"
completion_percentage?string
Default"any"
Value in"any" | "0-25" | "25-50" | "50-75" | "75-100"
pre_handover_payment?integer
  • Max pre-handover percentage, e.g., 50
Range0 <= value <= 100

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-new-projects" \  -H "X-RapidAPI-Host: bayut14.p.rapidapi.com"
{
  "success": true,
  "data": {
    "properties": [
      null
    ],
    "total": 0,
    "page": 0,
    "totalPages": 0,
    "hitsPerPage": 0
  }
}
{
  "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"
}