# Property Finder UAE Properties for Rent API

> Residential properties for rent across the UAE with rent price and period, bedrooms, bathrooms, size, furnishing, number of cheques, location, amenities, images, agent and broker.

- Page: https://cleanedweb.com/catalog/property-finder-uae-properties-for-rent-api/
- Contract (JSON): https://cleanedweb.com/catalog/property-finder-uae-properties-for-rent-api/contract.json
- Source: propertyfinder.ae (https://www.propertyfinder.ae/)
- Category: Real estate
- Countries: United Arab Emirates
- Languages: English
- Updated: 2026-11-19

## Limitations

- Rent is a number, such as 160000, with its currency (AED) and period (yearly) in their own fields. Bedrooms are text, such as "2".
- Amenities come as names in amenity_names and as the site's two-letter codes, such as AC, in amenities and amenities_code.

A run reads until the source ends or your `max_items`, `timeout_seconds` or budget stops it.

## Key fields

| Field | Type | Sample value |
| --- | --- | --- |
| `title` | string | `Exclusive Offer - 2 Months Rent Free \| Sea View` |
| `price` | integer | `160000` |
| `currency` | string | `AED` |
| `period` | string | `yearly` |
| `property_type` | string | `Apartment` |
| `bedrooms` | string | `1` |
| `bathrooms` | integer | `1` |
| `location_name` | string | `City Tower 1` |

Sample values come from one saved record, not a live run. Every field with its type, and the schemas, are in https://cleanedweb.com/catalog/property-finder-uae-properties-for-rent-api/contract.json. Some fields the source returns are not published, so a record can carry fields the schema does not list.

## Inputs

- `category` (string): Optional. Free text: any category the site serves, written with letters, hyphens and dots, up to 74 characters. A name the site does not serve is refused with input_value_unverified. Leave it out for the default listing. For example: villas-for-rent.html (Villas 26,391), townhouses-for-rent.html (Townhouses 12,970), hotels-hotel-apartments-for-rent.html (Hotel Apartments 1,142), penthouses-for-rent.html (Penthouses 571), duplexes-for-rent.html (Duplexes 507), whole-buildings-for-rent.html (Whole Buildings 169). Pattern: `^[A-Za-z][A-Za-z\-\.]{0,73}$`.
- `city` (string): Optional. The city the listing is in, one of the cities the page links from the listing. A city whose page repeats the default listing is not offered. Omit for the listing as the page shows it, which includes any city not offered. Options: abu-dhabi, sharjah, ajman, ras-al-khaimah.

`enrich_records` is on by default and adds the fields that only appear on each record's detail page. Send `false` to read list fields only. See https://cleanedweb.com/docs/run-api/

## Request

`POST https://api.cleanedweb.com/v1/catalog/public/apis/generated_c08c3cc0919a219a24d55c37/endpoints/generated_c08c3cc0919a219a24d55c37_search/run`

```bash
curl -X POST https://api.cleanedweb.com/v1/catalog/public/apis/generated_c08c3cc0919a219a24d55c37/endpoints/generated_c08c3cc0919a219a24d55c37_search/run \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Idempotency-Key: UNIQUE_REQUEST_ID" \
  -H "Content-Type: application/json" \
  -d '{
  "input": {
    "category": "villas-for-rent.html"
  },
  "version": 1,
  "max_items": 25
}'
```

Send an `Idempotency-Key` header with every run and save it before you send. Reuse it only to retry the same request. If the run does not end within `wait_seconds`, read the result with the same API key and key:

`GET https://api.cleanedweb.com/v1/catalog/public/apis/generated_c08c3cc0919a219a24d55c37/endpoints/generated_c08c3cc0919a219a24d55c37_search/result`

## Versions

Current: `1.0`. Pin a major with "version": N in the run body (an integer). Leave it out and the call runs on the latest major. A sunset major runs on the latest major and the response says rerouted. An unknown major answers 404 catalog_version_not_found and lists the available majors.

- v1: current, newest minor `1.0`

### Changelog

- `1.0` (major) 2026-11-06

The same changelog, as data, is in https://cleanedweb.com/catalog/property-finder-uae-properties-for-rent-api/contract.json

## Use it from an AI agent

MCP server: https://api.cleanedweb.com/mcp?profile=catalog (Streamable HTTP). Sign in with a CleanedWeb account when the client asks (OAuth), or send an API key with the `read` and `run` scopes as `Authorization: Bearer`. Call `get_api` with `api_id` `generated_c08c3cc0919a219a24d55c37`, then `run_api` with the `run_with` arguments it returns. See https://cleanedweb.com/docs/mcp/

## Run it

Reading the catalog needs no credential. Running needs a CleanedWeb account and an API key with the `run` scope; the first 5,000 records are free, then $1 per 1,000 records. See https://cleanedweb.com/docs/run-catalog-api/

CleanedWeb is not affiliated with Property Finder.
