Search properties for sale - PropertyfinderAPI Documentation

GET /search-buy

Search properties for sale

Description

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.

Parameters

Name	Type	Required	Description	Example
`location_id`	string	Required	- Location ID from `/autocomplete-location` endpoint - Example: `50` (Dubai Marina), `51` (Downtown Dubai) - Get IDs by searching location names first	`50`
`property_type`	string	Optional	- 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`	`apartment`
`bedrooms`	string	Optional	- 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	`0,1,2`
`bathrooms`	string	Optional	- Number of bathrooms as comma-separated values - Example: `1,2` for properties with 1 or 2 bathrooms - Example: `3` for 3-bathroom only	`1,2`
`price_min`	string	Optional	- Minimum sale price in AED - Examples: `500000`, `1000000`, `2000000`	`500000`
`price_max`	string	Optional	- Maximum sale price in AED - Examples: `1000000`, `3000000`, `5000000`	`3000000`
`completion_status`	string	Optional	- Property completion status - Options: `ready` (completed properties), `off_plan` (under construction) - Leave empty to show all properties	`ready`
`area_min`	string	Optional	- Minimum property area in sqft - Examples: `500`, `1000`, `2000`	`500`
`area_max`	string	Optional	- Maximum property area in sqft - Examples: `1000`, `2000`, `5000`	`3000`
`furnishing`	string	Optional	- Furnishing status filter - Options: `furnished`, `unfurnished`, `partly`	`furnished`
`amenities`	string	Optional	- 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`	`balcony,shared_pool`
`sort`	string	Optional	- Sort order for results - Options: `newest`, `featured`, `price_asc`, `price_desc` - Default: `newest`	`newest`
`page`	string	Optional	- Page number for pagination - Default: `1` - Examples: `1`, `2`, `3`	`1`

Code Examples

curl --request GET \
  --url 'https://propertyfinder-uae-data.p.rapidapi.com/search-buy?location_id=50' \
  --header 'x-rapidapi-host: propertyfinder-uae-data.p.rapidapi.com' \
  --header 'x-rapidapi-key: YOUR_API_KEY'

import requests

url = "https://propertyfinder-uae-data.p.rapidapi.com/search-buy"
querystring = {"location_id": "50"}
headers = {
    "x-rapidapi-key": "YOUR_API_KEY",
    "x-rapidapi-host": "propertyfinder-uae-data.p.rapidapi.com"
}

response = requests.get(url, headers=headers, params=querystring)
print(response.json())

const url = 'https://propertyfinder-uae-data.p.rapidapi.com/search-buy?location_id=50';

const options = {
  method: 'GET',
  headers: {
    'x-rapidapi-key': 'YOUR_API_KEY',
    'x-rapidapi-host': 'propertyfinder-uae-data.p.rapidapi.com'
  }
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

Example Response

Response

{
  "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"
    }
  ]
}

Try this endpoint now

Subscribe to PropertyfinderAPI on RapidAPI and start making requests in minutes.

Get API Key View Pricing