Happy Endpoint

Search properties for sale

Search residential properties available for purchase in UAE. Filter by location, property type, bedrooms, bathrooms, price range, completion status, amenities, and more. Returns parsed, structured data.

GET
/search-buy

Query Parameters

location_id*string
  • Location ID from /autocomplete-location endpoint
  • Example: 50 (Dubai Marina), 51 (Downtown Dubai)
  • Get IDs by searching location names first
Length1 <= length
property_type?string
  • Type of property to search
  • Common: apartment, villa, penthouse
  • All options: apartment, villa, townhouse, penthouse, compound, duplex, full-floor, half-floor, whole-building, bulk-rent-unit, bungalow, hotel-apartment
Value in"apartment" | "villa" | "townhouse" | "penthouse" | "compound" | "duplex" | "full-floor" | "half-floor" | "whole-building" | "bulk-rent-unit" | "bungalow" | "hotel-apartment" | "office-space" | "retail" | "warehouse" | "shop" | "show-room" | "land" | "factory" | "labor-camp" | "staff-accommodation" | "business-centre" | "co-working-space" | "farm"
bedrooms?string
  • Number of bedrooms as comma-separated values
  • Use 0 for studio apartments
  • Example: 0,1,2 for studio, 1-bed and 2-bed properties
  • Example: 3 for 3-bedroom only
bathrooms?string
  • Number of bathrooms as comma-separated values
  • Example: 1,2 for properties with 1 or 2 bathrooms
  • Example: 3 for 3-bathroom only
price_min?string
  • Minimum sale price in AED
  • Examples: 500000, 1000000, 2000000
price_max?string
  • Maximum sale price in AED
  • Examples: 1000000, 3000000, 5000000
completion_status?string
  • Property completion status
  • Options: ready (completed properties), off_plan (under construction)
  • Leave empty to show all properties
Value in"off_plan" | "ready"
area_min?string
  • Minimum property area in sqft
  • Examples: 500, 1000, 2000
area_max?string
  • Maximum property area in sqft
  • Examples: 1000, 2000, 5000
furnishing?string
  • Furnishing status filter
  • Options: furnished, unfurnished, partly
Value in"furnished" | "unfurnished" | "partly"
amenities?string
  • Filter by property amenities as comma-separated values
  • Options: central_ac, balcony, maids_room, shared_pool, shared_gym, covered_parking, pets_allowed, private_garden, private_pool, security, built_in_wardrobes, view_of_water, view_of_landmark, concierge, childrens_play_area, bbq_area
  • Example: balcony,shared_pool,covered_parking
sort?string
  • Sort order for results
  • Options: newest, featured, price_asc, price_desc
  • Default: newest
Default"newest"
Value in"newest" | "featured" | "price_asc" | "price_desc"
page?string
  • Page number for pagination
  • Default: 1
  • Examples: 1, 2, 3
Default"1"

Header Parameters

X-RapidAPI-Host*string
Default"propertyfinder-uae-data.p.rapidapi.com"

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/search-buy?location_id=50" \  -H "X-RapidAPI-Host: propertyfinder-uae-data.p.rapidapi.com"
{
  "success": true,
  "data": [
    {
      "property_id": "16266089",
      "property_type": "Apartment",
      "price": {
        "value": 20000,
        "currency": "AED",
        "period": "monthly",
        "is_hidden": false
      },
      "address": {
        "full_name": "Marina Tower, Dubai Marina, Dubai",
        "coordinates": {
          "lat": 25.0837707519531,
          "lon": 55.145076751709
        }
      },
      "images": [
        "https://static.shared.propertyfinder.ae/media/images/listing/APY6G1E8KBFYKHWEKPD6PWYNJ4/2aee8d5d-303a-426f-b17c-c6241bcffc7f/416x272.jpg",
        "https://static.shared.propertyfinder.ae/media/images/listing/APY6G1E8KBFYKHWEKPD6PWYNJ4/d4b57dbd-e311-4710-878e-49ea04aceb7d/416x272.jpg",
        "https://static.shared.propertyfinder.ae/media/images/listing/APY6G1E8KBFYKHWEKPD6PWYNJ4/bee788f7-798c-4164-bb04-512bbc551541/416x272.jpg",
        "https://static.shared.propertyfinder.ae/media/images/listing/APY6G1E8KBFYKHWEKPD6PWYNJ4/94358193-dc88-4147-948a-c98329bc81dc/416x272.jpg"
      ],
      "agent_details": {
        "id": "365444",
        "name": "Sharie Ann Delizo",
        "is_super_agent": false,
        "image": "",
        "languages": []
      },
      "broker_id": "9676",
      "bedrooms": "1",
      "bathrooms": "2",
      "size": {
        "value": 768,
        "unit": "sqft"
      },
      "floor_plan_area": 768,
      "title": "Elegant Escapes - 1B in Marina, Partial Sea View",
      "property_url": "https://www.propertyfinder.ae/en/plp/rent/apartment-for-rent-dubai-dubai-marina-marina-tower-16266089.html"
    }
  ]
}
{
  "success": true,
  "error": "string",
  "code": 0
}
{
  "success": true,
  "error": "string",
  "code": 0
}
{
  "success": true,
  "error": "string",
  "code": 0
}
{
  "success": true,
  "error": "string",
  "code": 0
}

Search properties for rentGET

Search residential properties available for rent in UAE. Filter by location, property type, bedrooms, bathrooms, price range, amenities, and more. Returns parsed, structured data.

Search commercial properties for rentGET

Search commercial properties available for rent in UAE. Filter by location, property type, price range, and area. Returns parsed, structured data.