--- title: "iProperty API: Search | Perceptlayer" description: "Search from iProperty as JSON. 1 credit per successful call." url: https://perceptlayer.com/apis/iproperty/search --- [APIs](https://perceptlayer.com/apis) / [iProperty](https://perceptlayer.com/apis/iproperty) / Search # iProperty: Search Search from iProperty as JSON. 1 credit per successful call. GET `/v1/iproperty/search` ## Parameters Send parameters in the query string. | Parameter | Type | Required | Allowed values | | --- | --- | --- | --- | | `listing_type` | string | Optional | sale, rent | | `location` | string | Optional | Up to 120 characters | | `page` | integer | Optional | Any | | `bedrooms` | integer | Optional | Any | | `bathrooms` | integer | Optional | Any | | `car_park` | integer | Optional | Any | | `min_price` | integer | Optional | Any | | `max_price` | integer | Optional | Any | | `min_size` | integer | Optional | Any | | `max_size` | integer | Optional | Any | | `property_type` | string | Optional | bungalow, condo, semi\_detached, terrace, land, commercial, industrial, agricultural, other | | `commercial` | boolean | Optional | Any | | `furnishing` | string | Optional | unfurnished, partial, full | | `room_type` | string | Optional | master, common, shared | | `tenure` | string | Optional | freehold, leasehold, bumi\_lot, malay\_reserved, private\_lease | | `floor_level` | string | Optional | ground, low, mid, high, penthouse | | `keyword` | string | Optional | Up to 100 characters | | `posted_within` | integer | Optional | 3, 7, 14, 31 | | `agent_id` | string | Optional | Any | | `sort` | string | Optional | date, price, psf, size | | `order` | string | Optional | asc, desc | ## Example request iProperty GET /v1/iproperty/search?listing\_type=sale&location=in-kuala-lumpur-58jok&bedrooms=3&min\_price=0&max\_price=800000&sort=price&order=asc ``` { "success": true, "data": { "listing_type": "sale", "location": "in-kuala-lumpur-58jok", "currency": "MYR", "pagination": { "current_page": 1, "total_pages": 891, "total_results": 17814, "page_size": 24 }, "filters_applied": { "listing_type": "sale", "location": "in-kuala-lumpur-58jok", "bedrooms": "3", "min_price": "0", "max_price": "800000", "sort": "price", "order": "asc" }, "sort_options": [ { "label": "Newest", "sort": "date", "order": "desc" }, { "label": "Lowest Price", "sort": "price", "order": "asc" }, { "label": "Highest Price", "sort": "price", "order": "desc" } ], "items": [ { "id": 102251053, "url": "https://www.iproperty.com.my/property/mont-kiara/28-mont-kiara-mk-28/sale-102251053/", "title": "28 Mont Kiara @ MK28, Mont Kiara", "listing_type": "sale", "status": "ACT", "new_launch": false, "price": { "value": 8000, "formatted": "RM 8,000", "currency": "MYR" }, "bedrooms": 3, "is_studio": false, "bathrooms": 4, "car_parks": 3, "property_type": "Condominium", "property_group_name": "condo", "unit_type_details": "Corner Lot", "furnishing": "Fully Furnished", "tenure": "Freehold", "completion": "Completion: 2012", "address": "32 Jalan Kiara, Mont Kiara, Kuala Lumpur", "short_address": "Mont Kiara, Kuala Lumpur", "district": "Mont Kiara", "district_code": "q9qzw", "region": "Kuala Lumpur", "region_code": "58jok", "project_id": 1878, "new_project": false, "developer": "Terence Wee", "posted_at": "2026-09-14T18:50:44+00:00", "posted_text": "Listed on Sep 15, 2026 (1mo ago)", "thumbnail": "https://ipp1-cdn.pgimgs.com/listing/102251053/UPHO.304543299.V550.jpg", "images": [ "https://ipp1-cdn.pgimgs.com/listing/102251053/UPHO.304543299.V800/28-Mont-Kiara-MK28-Mont-Kiara-Malaysia.jpg", "https://ipp1-cdn.pgimgs.com/listing/102251053/UPHO.322947698.V800/28-Mont-Kiara-MK28-Mont-Kiara-Malaysia.jpg", "https://ipp1-cdn.pgimgs.com/listing/102251053/UPHO.306236901.V800/28-Mont-Kiara-MK28-Mont-Kiara-Malaysia.jpg" ], "media_counts": { "images": 6 }, "badges": [ "Completion: 2012", "Condominium", "Freehold" ], "is_official_listing": true, "is_developer_listing": false, "agent": { "id": 693852, "name": "Terence Wee", "verified": false, "profile_url": "https://www.iproperty.com.my/property-agent/terence-wee-693852/" } }, { "id": 502381018, "url": "https://www.iproperty.com.my/property/damansara-heights/aira-residence/sale-502381018/", "title": "Aira Residence, Damansara Heights", "listing_type": "sale", "status": "ACT", "new_launch": false, "price": { "value": 17900, "formatted": "RM 17,900", "currency": "MYR" }, "psf": { "value": 9.29, "text": "RM 9.29 psf" }, "bedrooms": 3, "is_studio": false, "bathrooms": 4, "floor_area_sqft": 1927, "floor_area_text": "1,927 sqft", "property_type": "Condominium", "property_group_name": "condo", "furnishing": "Fully Furnished", "tenure": "Freehold", "completion": "Completion: 2019", "address": "Jalan Batai, Damansara Heights, Kuala Lumpur", "short_address": "Damansara Heights, Kuala Lumpur", "district": "Damansara Heights", "district_code": "f3k46", "region": "Kuala Lumpur", "region_code": "58jok", "project_id": 15629, "new_project": false, "developer": "Kim Ching", "posted_at": "2026-11-04T13:36:27+00:00", "posted_text": "Listed on Nov 04, 2026 (1w ago)", "nearest_transit": "1.43 km (17 min) from Semantan", "thumbnail": "https://ipp1-cdn.pgimgs.com/listing/502381018/UPHO.393972711.V550.jpg", "images": [ "https://ipp1-cdn.pgimgs.com/listing/502381018/UPHO.393972711.V800/Aira-Residence-Damansara-Heights-Malaysia.jpg", "https://ipp1-cdn.pgimgs.com/listing/502381018/UPHO.393972713.V800/Aira-Residence-Damansara-Heights-Malaysia.jpg", "https://ipp1-cdn.pgimgs.com/listing/502381018/UPHO.393972714.V800/Aira-Residence-Damansara-Heights-Malaysia.jpg" ], "media_counts": { "images": 22 }, "badges": [ "Completion: 2019", "Condominium", "Freehold" ], "is_official_listing": true, "is_developer_listing": false, "agent": { "id": 1300205, "name": "Kim Ching", "license": "REN83459", "verified": true, "profile_url": "https://www.iproperty.com.my/property-agent/kim-ching-1300205/" } }, { "id": 502026892, "url": "https://www.iproperty.com.my/property/kepong/impiana-apartment/sale-502026892/", "title": "Impiana Apartment, Taman Wangsa Permai, Kepong", "listing_type": "sale", "status": "ACT", "new_launch": false, "price": { "value": 100000, "formatted": "RM 100,000", "currency": "MYR" }, "psf": { "value": 145.99, "text": "RM 145.99 psf" }, "bedrooms": 3, "is_studio": false, "bathrooms": 2, "floor_area_sqft": 685, "floor_area_text": "685 sqft", "property_type": "Apartment", "property_group_name": "condo", "unit_type_details": "Intermediate", "furnishing": "Partially Furnished", "tenure": "Leasehold", "address": "Jalan Wangsa 3/7 Jalan Wangsa 3/6, Taman Wangsa Permai, Kepong, Kuala Lumpur", "short_address": "Taman Wangsa Permai, Kepong, Kuala Lumpur", "area": "Taman Wangsa Permai", "district": "Kepong", "district_code": "jp1ux", "region": "Kuala Lumpur", "region_code": "58jok", "project_id": 5006, "new_project": false, "developer": "Ben Mok", "posted_at": "2026-11-07T00:00:16+00:00", "posted_text": "Listed on Nov 07, 2026 (5d ago)", "thumbnail": "https://ipp1-cdn.pgimgs.com/listing/502026892/UPHO.389641442.V550.jpg", "images": [ "https://ipp1-cdn.pgimgs.com/listing/502026892/UPHO.389641442.V800/Impiana-Apartment-Taman-Wangsa-Permai-Malaysia.jpg", "https://ipp1-cdn.pgimgs.com/listing/502026892/UPHO.389641417.V800/Impiana-Apartment-Taman-Wangsa-Permai-Malaysia.jpg", "https://ipp1-cdn.pgimgs.com/listing/502026892/UPHO.389641374.V800/Impiana-Apartment-Taman-Wangsa-Permai-Malaysia.jpg" ], "media_counts": { "images": 10 }, "badges": [ "Apartment", "Leasehold" ], "is_official_listing": true, "is_developer_listing": false, "agent": { "id": 879919, "name": "Ben Mok", "license": "REN18388", "verified": true, "profile_url": "https://www.iproperty.com.my/property-agent/ben-mok-879919/" } } ] }, "meta": { "endpoint_family": "search", "removed_by_filter": 4, "request_id": "req_413c69a7e93e4974a1ba152b9bc3df53", "credits_charged": 1, "credits_remaining": 1797 } } ``` 200 OK JSON X-Credits-Used: 1 Recorded from our API and shortened. [Run this endpoint in the playground](https://perceptlayer.com/apis/iproperty?try=search#playground) with your own parameters. 1 credit per successful call; failed calls are free.