Happy Endpoint

Search properties for rent or sale

Search properties on Bayut or PropertyFinder. Pass a location name (e.g. 'Dubai Marina') and we auto-resolve it, or pass a location_id directly for faster results. Filter by property type, bedrooms, price range, area, and more.

GET
/search-properties

Authorization

RapidApiKey
X-RapidAPI-Key<token>

In: header

Query Parameters

platform*string
  • Data source platform
  • bayut — Search on Bayut
  • propertyfinder — Search on PropertyFinder
Value in"bayut" | "propertyfinder"
purpose*string
  • Transaction type
  • rent — Properties for rent
  • buy — Properties for sale
Value in"rent" | "buy"
location?string
  • Location name (e.g. Dubai Marina, Business Bay, JBR)
  • We auto-resolve this to a location ID internally
  • Either location or location_id is required
Length1 <= length <= 200
location_id?string
  • Platform-specific location ID
  • Get this from the /autocomplete endpoint
  • Faster than using location (skips auto-resolve step)
  • Either location or location_id is required
page?integer
  • Page number (starts from 1)
Default1
Range1 <= value
sort?string
  • Sort order
  • popular — Most popular (default)
  • newest — Most recent listings
  • price_low — Cheapest first
  • price_high — Most expensive first
Default"popular"
Value in"popular" | "newest" | "price_low" | "price_high"
property_type?string
  • Comma-separated property types
  • Options: apartment, villa, townhouse, penthouse, office, shop, warehouse, hotel-apartment
bedrooms?string
  • Comma-separated number of bedrooms
  • 0 = Studio
  • Example: 0,1,2 for studio, 1-bed, 2-bed
bathrooms?string
  • Comma-separated number of bathrooms
price_min?integer
  • Minimum price in AED
Range0 <= value
price_max?integer
  • Maximum price in AED
Range0 <= value
area_min?number
  • Minimum area in Square Feet (sqft)
Range0 <= value
area_max?number
  • Maximum area in Square Feet (sqft)
Range0 <= value
furnishing?string
  • Furnishing status filter
Value in"furnished" | "unfurnished"
completion_status?string
  • Completion status
  • ready — Completed/ready to move in
  • off_plan — Under construction
Value in"ready" | "off_plan"
rent_frequency?string
  • Rent payment frequency (only for rent purpose)
  • Default: yearly
Value in"yearly" | "monthly" | "weekly" | "daily"

Header Parameters

X-RapidAPI-Host*string
Default"uae-real-estate-api.p.rapidapi.com"

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/search-properties?platform=bayut&purpose=rent" \  -H "X-RapidAPI-Host: uae-real-estate-api.p.rapidapi.com"
{
  "success": true,
  "platform": "bayut",
  "data": {
    "properties": [
      null
    ],
    "total": 245,
    "page": 1,
    "totalPages": 10,
    "hitsPerPage": 25
  }
}
{
  "success": false,
  "message": "Invalid request: Missing required parameter",
  "error": "VALIDATION_ERROR"
}
{
  "success": false,
  "message": "No locations found for \"xyz\" on bayut",
  "error": "NOT_FOUND"
}
{
  "success": false,
  "message": "Internal server error. Please try again later.",
  "error": "INTERNAL_ERROR"
}
{
  "success": false,
  "message": "Service temporarily unavailable. Please try again later.",
  "error": "PLATFORM_ERROR"
}

Search for locations on Bayut or PropertyFinderGET

Search for location names and get their platform-specific IDs. Use the returned location_id in the /search-properties endpoint for faster searches (skips auto-resolve).

Get detailed property informationGET

Get full details for a specific property by its ID. Use the property ID from search results.