{"name":"Property Finder UAE Properties for Rent API","description":"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.","api_id":"generated_c08c3cc0919a219a24d55c37","slug":"property-finder-uae-properties-for-rent-api","source":{"name":"Property Finder","domain":"propertyfinder.ae","url":"https://www.propertyfinder.ae/"},"category":"real_estate","countries":["AE"],"languages":["en"],"record_types":[],"tags":[],"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."],"updated":"2026-11-19","note":"Sample records are saved samples, not a live run. CleanedWeb is not affiliated with the source.","version":"1.0","versions":[{"major":1,"latest_minor":"1.0","status":"current","sunset_at":null}],"changelog":[{"version":"1.0","date":"2026-11-06T21:54:40.000Z","kind":"major","changes":[]}],"version_note":"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.","endpoints":[{"endpoint_id":"generated_c08c3cc0919a219a24d55c37_search","name":"Extract records","description":"Return records within the accepted scope.","definition_version":"3df4304b94b26a5af995df830574ecf4ee07f3b832f814e27aea77beee8abc47","method":"POST","path":"/v1/catalog/public/apis/generated_c08c3cc0919a219a24d55c37/endpoints/generated_c08c3cc0919a219a24d55c37_search/run","url":"https://api.cleanedweb.com/v1/catalog/public/apis/generated_c08c3cc0919a219a24d55c37/endpoints/generated_c08c3cc0919a219a24d55c37_search/run","authentication":{"type":"bearer","scheme":"Authorization: Bearer <API key>","scope":"run","note":"Reading this file and the live catalog needs no credential. A run needs a CleanedWeb account and uses the credits of its workspace.","docs":"https://cleanedweb.com/docs/run-catalog-api/"},"required_headers":[{"name":"Authorization","value":"Bearer YOUR_API_KEY","description":"An API key with the run scope."},{"name":"Idempotency-Key","value":"UNIQUE_REQUEST_ID","description":"Required. Save it before you send; reuse it only to retry the same request and to read the result. 1-200 characters: letters, numbers, . _ : -"},{"name":"Content-Type","value":"application/json","description":"The body is JSON."}],"request_body":{"input":"An object that follows input_schema.","max_items":"Optional. Stop after this many records.","timeout_seconds":"Optional, 60-86400, default 10800.","wait_seconds":"Optional, 0-86400, default 90. How long the request waits before answering 202.","version":"Optional integer major. Leave it out for the latest major."},"input_schema":{"type":"object","properties":{"enrich_records":{"type":"boolean","default":true,"description":"true: read each returned record's product/detail page and merge its fields into the record. false: return list/search-level fields only, with no detail page reads. Every returned record's detail page is read within the run's time budget; records the time budget leaves unread are returned without detail fields, and summary.record_enrichment reports how many records were enriched and why any were not (run_time_budget). Detail fields are optional."},"category":{"x-enum-labels":["Villas 26,391","Townhouses 12,970","Hotel Apartments 1,142","Penthouses 571","Duplexes 507","Whole Buildings 169"],"x-value-status":["observed","verified","observed","verified","observed","observed"],"x-source-key":"category","type":"string","pattern":"^[A-Za-z][A-Za-z\\-\\.]{0,73}$","minLength":1,"maxLength":74,"examples":["villas-for-rent.html","townhouses-for-rent.html","hotels-hotel-apartments-for-rent.html","penthouses-for-rent.html","duplexes-for-rent.html","whole-buildings-for-rent.html"],"x-open-values":true,"description":"Optional. The name of a page of the same kind as the pages the pasted one links (any name that fits the pattern; the examples are the names it links). The site decides: a name it does not serve is refused as input_value_unverified. Omit for the pasted page (its own name asks for it too).","not":{"type":"string","pattern":"\\n"},"x-source-route":"path_segment"},"city":{"x-enum-labels":["abu-dhabi","sharjah","ajman","ras-al-khaimah"],"x-value-status":["verified","verified","observed","observed"],"description":"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.","x-source-key":"city","type":"string","enum":["abu-dhabi","sharjah","ajman","ras-al-khaimah"],"x-source-route":"path_segment"}},"required":[],"additionalProperties":false},"output_schema":{"type":"object","additionalProperties":true,"required":["title","url"],"properties":{"agent":{"additionalProperties":{"type":["null","boolean","integer","number","string","array","object"]},"properties":{"id":{"type":["string"]},"image":{"type":["string"]},"is_super_agent":{"type":["boolean"]},"languages":{"items":{"type":["string"]},"type":["array"]},"name":{"type":["string"]},"slug":{"type":["string"]}},"type":"object"},"amenities":{"items":{"type":["string"]},"type":"array"},"amenity_names":{"items":{"type":["string"]},"type":"array"},"bathrooms":{"type":"integer"},"bedrooms":{"type":"string"},"bedrooms_value":{"type":["integer","number"]},"broker":{"additionalProperties":{"type":["null","boolean","integer","number","string","array","object"]},"properties":{"address":{"type":["string"]},"id":{"type":["string"]},"logo":{"type":["string"]},"name":{"type":["string"]},"slug":{"type":["string"]}},"type":"object"},"category_id":{"type":["integer","number"]},"completion_status":{"type":"string"},"description":{"type":"string"},"floor_plans":{"items":{"additionalProperties":{"type":["null","boolean","integer","number","string","array","object"]},"properties":{"area":{"type":["integer","number"]},"dimension":{"type":["string"]},"floor_number":{"type":["integer","number"]},"id":{"type":["string"]},"image_url":{"type":["string"]},"unit_number":{"type":["string"]}},"type":["object"]},"type":"array"},"furnished":{"type":"string"},"has_view_360":{"type":"boolean"},"id":{"type":"string"},"images":{"items":{"additionalProperties":{"type":["null","boolean","integer","number","string","array","object"]},"properties":{"classification_label":{"type":["string"]},"medium":{"type":["string"]},"small":{"type":["string"]}},"type":["object"]},"type":"array"},"images_count":{"type":["integer","number"]},"is_available":{"type":"boolean"},"is_broker_project_property":{"type":"boolean"},"is_claimed_by_agent":{"type":"boolean"},"is_community_expert":{"type":"boolean"},"is_cts":{"type":"boolean"},"is_direct_from_developer":{"type":"boolean"},"is_exclusive":{"type":"boolean"},"is_extended":{"type":"boolean"},"is_featured":{"type":"boolean"},"is_fhm":{"type":"boolean"},"is_great_value":{"type":"boolean"},"is_high_demand":{"type":"boolean"},"is_landscaped":{"type":"boolean"},"is_luxe":{"type":"boolean"},"is_new_construction":{"type":"boolean"},"is_new_insert":{"type":"boolean"},"is_pf_exclusive":{"type":"boolean"},"is_premium":{"type":"boolean"},"is_price_drop":{"type":"boolean"},"is_smart_ad":{"type":"boolean"},"is_spotlight_listing":{"type":"boolean"},"is_under_offer_by_competitor":{"type":"boolean"},"is_upgraded":{"type":"boolean"},"is_verified":{"type":"boolean"},"last_refreshed_at":{"type":["array","boolean","integer","number","object","string"]},"lead_value":{"type":["integer","number"]},"listed_date":{"type":"string"},"listing_id":{"type":"string"},"listing_level":{"type":"string"},"listing_level_label":{"type":"string"},"live_viewing":{"type":["array","boolean","integer","number","object","string"]},"location":{"type":"string"},"location_details":{"additionalProperties":{"type":["null","boolean","integer","number","string","array","object"]},"properties":{"full_name":{"type":["string"]},"id":{"type":["string"]},"insights_url":{"type":["string"]},"name":{"type":["string"]},"path":{"type":["string"]},"path_name":{"type":["string"]},"slug":{"type":["string"]},"type":{"type":["string"]}},"type":"object"},"location_tree":{"items":{"additionalProperties":{"type":["null","boolean","integer","number","string","array","object"]},"properties":{"id":{"type":["string"]},"insights_url":{"type":["string"]},"level":{"type":["string"]},"name":{"type":["string"]},"slug":{"type":["string"]},"slug_en":{"type":["string"]},"type":{"type":["string"]}},"type":["object"]},"type":"array"},"mortgage_cashback":{"type":["integer","number"]},"number_of_cheques":{"type":["integer","number"]},"offering_type":{"type":"string"},"payment_method":{"items":{},"type":"array"},"plot_size":{"type":["integer","number"]},"price":{"type":"integer"},"price_details":{"additionalProperties":{"type":["null","boolean","integer","number","string","array","object"]},"properties":{"currency":{"type":["string"]},"is_hidden":{"type":["boolean"]},"period":{"type":["string"]},"value":{"type":["integer","number"]}},"type":"object"},"price_per_area":{"type":["array","boolean","integer","number","object","string"]},"property_type":{"type":"string"},"property_type_id":{"type":["integer","number"]},"qs":{"type":["integer","number"]},"rank_score":{"type":["integer","number"]},"ranking_factors":{"type":"string"},"reference":{"type":"string"},"rera":{"type":"string"},"rnpm":{"additionalProperties":{"type":["null","boolean","integer","number","string","array","object"]},"properties":{"enabled":{"type":["boolean"]}},"type":"object"},"rooms":{"type":["array","boolean","integer","number","object","string"]},"rooms_value":{"type":["array","boolean","integer","number","object","string"]},"rsp":{"type":["integer","number"]},"size":{"additionalProperties":{"type":["null","boolean","integer","number","string","array","object"]},"properties":{"unit":{"type":["string"]},"value":{"type":["integer","number"]}},"type":"object"},"spec_area":{"type":"string"},"styles_module_content_listing_level_9tlxy":{"type":["string"]},"title":{"type":"string"},"travel_time_tags":{"items":{},"type":"array"},"url":{"type":"string","format":"uri"},"utilities_price_type":{"type":"string"},"video_url":{"type":"string"},"view_360":{"type":"string"},"detail_amenities":{"type":"string"},"detail_location":{"type":"string"},"prices_trends":{"type":"string"},"detail_price":{"type":"string"},"currency":{"type":"string"},"period":{"type":"string"},"is_hidden":{"type":"string"},"location_id":{"type":"string"},"full_name":{"type":"string"},"location_slug":{"type":"string"},"path":{"type":"string"},"location_type":{"type":"string"},"location_name":{"type":"string"},"path_name":{"type":"string"},"top_location_id":{"type":"string"},"location_insights_url":{"type":"string"},"images_property_medium":{"type":"string"},"images_property_full":{"type":"string"},"images_property_thumbnail":{"type":"string"},"images_community_full":{"type":"string"},"images_community_thumbnail":{"type":"string"},"agent_id":{"type":"string"},"image":{"type":"string"},"is_super_agent":{"type":"string"},"agent_name":{"type":"string"},"agent_languages":{"type":"string"},"agent_slug":{"type":"string"},"avg_whatsapp_response_time":{"type":"string"},"agent_total_properties":{"type":"string"},"position":{"type":"string"},"years_of_experience":{"type":"string"},"transactions_count":{"type":"string"},"score1":{"type":"string"},"score2":{"type":"string"},"score3":{"type":"string"},"score4":{"type":"string"},"score5":{"type":"string"},"detail_url":{"type":"string"},"broker_id":{"type":"string"},"broker_logo":{"type":"string"},"broker_name":{"type":"string"},"broker_slug":{"type":"string"},"broker_total_properties":{"type":"string"},"broker_license_number":{"type":"string"},"broker_is_exclusive":{"type":"string"},"broker_total_agents":{"type":"string"},"broker_total_super_agents":{"type":"string"},"detail_size":{"type":"string"},"unit":{"type":"string"},"phase_id":{"type":"string"},"delivery_date":{"type":"string"},"project_id":{"type":"string"},"project_slug":{"type":"string"},"uuid":{"type":"string"},"project_property_types":{"type":"string"},"project_developer_id":{"type":"string"},"project_developer_name":{"type":"string"},"project_developer_logo":{"type":"string"},"project_developer_slug":{"type":"string"},"construction_phase_key":{"type":"string"},"project_images":{"type":"string"},"project_beds":{"type":"string"},"amenities_code":{"type":"string"},"detail_rsp":{"type":"string"},"detail_rss":{"type":"string"},"permit_validation_url":{"type":"string"},"authority_name":{"type":"string"},"issued_license_number":{"type":"string"},"detail_is_spotlight_listing":{"type":"string"},"location_tree_id":{"type":"string"},"location_tree_name":{"type":"string"},"location_tree_type":{"type":"string"},"location_tree_slug":{"type":"string"},"location_tree_level":{"type":"string"},"location_tree_insights_url":{"type":"string"},"rental_availability_date":{"type":"string"},"share_url_translated":{"type":"string"},"zone_name":{"type":"string"},"licenses_license_type":{"type":"string"},"licenses_license_number":{"type":"string"},"client_id":{"type":"string"},"client_logo":{"type":"string"},"client_name":{"type":"string"},"client_slug":{"type":"string"},"client_total_properties":{"type":"string"},"client_license_number":{"type":"string"},"client_is_exclusive":{"type":"string"},"client_total_agents":{"type":"string"},"client_total_super_agents":{"type":"string"},"property_details_id":{"type":"string"},"property_details_display_format":{"type":"string"},"regulatory_details_id":{"type":"string"},"regulatory_details_display_format":{"type":"string"},"description_original":{"type":"string"},"enabled":{"type":"string"},"listed":{"type":"string","description":"Listed"},"listing_title":{"type":"string"},"city":{"type":"string"},"community":{"type":"string"},"subcommunity":{"type":"string"},"building":{"type":"string"},"listing_url":{"type":"string"},"typed_transactions_count":{"type":"integer","minimum":0,"description":"Reviewed numeric reading of transactions_count; source value is preserved."}}},"output_schema_note":"Some fields the source returns are not published here (identifiers, personal details and page-building noise). A record can carry fields this schema does not list, so additionalProperties is true. Do not reject a record for an extra field. The live contract, linked as live_contract, lists every field the saved definition declares.","examples":[{"kind":"saved_validation_records","saved_at":"2026-11-06T21:54:40.346Z","live_verified":false,"request":{"input":{}},"records_shown":2,"records_saved":2,"records":[{"title":"Exclusive Offer - 2 Months Rent Free | Sea View","price":160000,"currency":"AED","period":"yearly","property_type":"Apartment","bedrooms":"1","bathrooms":1,"furnished":"NO","location_name":"City Tower 1","url":"https://www.propertyfinder.ae/en/plp/rent/apartment-for-rent-dubai-world-trade-center-trade-centre-first-city-towers-city-tower-1-165588928.html"},{"title":"2 Months Rent Free | 2BR Apartment | Large Balcony","price":111500,"currency":"AED","period":"yearly","property_type":"Apartment","bedrooms":"2","bathrooms":3,"furnished":"NO","location_name":"DHP Residency 2","url":"https://www.propertyfinder.ae/en/plp/rent/apartment-for-rent-dubai-dubai-silicon-oasis-dhp-residency-2-169712066.html"}]}],"request_example":{"body":{"input":{"category":"villas-for-rent.html"},"version":1,"max_items":25},"curl":"curl -X POST https://api.cleanedweb.com/v1/catalog/public/apis/generated_c08c3cc0919a219a24d55c37/endpoints/generated_c08c3cc0919a219a24d55c37_search/run \\\n  -H \"Authorization: Bearer YOUR_API_KEY\" \\\n  -H \"Idempotency-Key: UNIQUE_REQUEST_ID\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n  \"input\": {\n    \"category\": \"villas-for-rent.html\"\n  },\n  \"version\": 1,\n  \"max_items\": 25\n}'"},"result":{"method":"GET","url":"https://api.cleanedweb.com/v1/catalog/public/apis/generated_c08c3cc0919a219a24d55c37/endpoints/generated_c08c3cc0919a219a24d55c37_search/result","note":"A run that does not end within wait_seconds answers 202. Read the result with the same API key and the same Idempotency-Key."},"links":{"page":"https://cleanedweb.com/catalog/property-finder-uae-properties-for-rent-api/","markdown":"https://cleanedweb.com/catalog/property-finder-uae-properties-for-rent-api/index.md","live_contract":"https://app.cleanedweb.com/api/catalog/apis/generated_c08c3cc0919a219a24d55c37/endpoints/generated_c08c3cc0919a219a24d55c37_search/contract","run_docs":"https://cleanedweb.com/docs/run-catalog-api/"}}],"links":{"page":"https://cleanedweb.com/catalog/property-finder-uae-properties-for-rent-api/","markdown":"https://cleanedweb.com/catalog/property-finder-uae-properties-for-rent-api/index.md","contract":"https://cleanedweb.com/catalog/property-finder-uae-properties-for-rent-api/contract.json","catalog":"https://cleanedweb.com/catalog/","index":"https://cleanedweb.com/catalog/index.json","openapi":"https://cleanedweb.com/catalog/openapi.json"}}
