propertyfinder.ae APIpropertyfinder.ae ↗
Search UAE property listings, agents, and broker companies via the PropertyFinder API. Get prices, locations, amenities, ratings, and transaction history.
curl -X GET 'https://api.parse.bot/scraper/655aaf4d-c785-4a58-aa77-9fc5a41fc908/get_location_suggestions?query=Dubai+Marina' \ -H 'X-API-Key: $PARSE_API_KEY'
Autocomplete suggestions for locations (cities, communities, buildings). Returns location IDs for use in search_properties.
| Param | Type | Description |
|---|---|---|
| queryrequired | string | Location search query (e.g., 'Dubai Marina', 'Downtown', 'Palm Jumeirah') |
{
"type": "object",
"fields": {
"data": "array of location objects with id, name, path, and parent info",
"status": "string indicating success"
},
"sample": {
"data": [
{
"a": "",
"n": "Dubai Marina",
"p": "1.50",
"id": "50",
"p_n": "Dubai",
"i_c_v": true,
"i_t_v": false
}
],
"status": "success"
}
}About the propertyfinder.ae API
The PropertyFinder UAE API gives you access to 7 endpoints covering property listings, agent profiles, and broker companies across the UAE. Use search_properties to filter by price, bedrooms, bathrooms, area, and category (buy or rent), returning paginated results with up to 25 listings per page including AED pricing, GPS-ready location data, agent contact details, and full amenity arrays. Location autocomplete, company search, and individual agent profiles round out the surface.
Property Search and Listing Data
The search_properties endpoint accepts filters for category (buy or rent), bedrooms, bathrooms, min_area/max_area in sqft, and max_price in AED. Results are paginated at 25 items per page and include a pagination object with total_count, total_pages, and current_page. Each property object carries id, title, price, location, agent, broker, images, size, description, and amenities. The sort parameter accepts mr (most recent), pl (price low to high), or ph (price high to low). For location-targeted searches, call get_location_suggestions first — it returns id, name, path, and parent info for cities, communities, and buildings — and pass the resulting location ID into your search query.
Agent and Broker Profiles
search_agents returns agent profiles including phone, email, superagent status, star ratings, transaction history, and associated broker details, with support for filtering by category_id (1 for sale, 2 for rent) and a free-text query parameter. get_agent_details expands a single agent record using the name-id slug format (constructed from the slug and id fields in search results) and adds areasOfExpertise, claimedTransactionsList, averageRating, and totalProperties.
Broker Company Data
search_companies lets you query broker companies by name, returning a brokers array with fields for id, name, urlSlug, phone, email, totalProperties, totalAgents, address, and licenseNumber. Pass the urlSlug from those results into get_company_details to retrieve the full company profile including description, logo, awards, and an associated listings array of active property records for that company.
Known Limitations
The get_property_details endpoint retrieves data for a single listing by slug_url, but this route is subject to AWS WAF protection and may return a blocked status. For reliable single-property data, the search_properties endpoint returns the same core fields and is the recommended path for production use.
- Aggregate buy and rent listings across UAE communities with price, size, and amenity data for a property search portal.
- Build an agent comparison tool using ratings, transaction counts, and areas of expertise from get_agent_details.
- Monitor AED price trends across bedroom categories in specific Dubai locations using search_properties with location IDs.
- Enrich a CRM with broker company profiles including license numbers, agent counts, and contact info from search_companies.
- Power a location autocomplete field in a UAE property app using get_location_suggestions.
- Identify top-performing brokerages by total listed properties using get_company_details and its associated listings array.
- Filter available rental inventory by bathroom count and area range for a relocation service targeting specific neighborhoods.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.