---
title: "Mudah.my Property API: Search | Perceptlayer"
description: "Search from Mudah.my Property as JSON. 1 credit per successful call."
url: https://perceptlayer.com/apis/mudah-my-property/search
---

[APIs](https://perceptlayer.com/apis) / [Mudah.my Property](https://perceptlayer.com/apis/mudah-my-property) / Search

# Mudah.my Property: Search

Search from Mudah.my Property as JSON. 1 credit per successful call.

GET `/v1/mudah-my-property/search`

## Parameters

Send parameters in the query string.

| Parameter | Type | Required | Allowed values |
| --- | --- | --- | --- |
| `listing_type` | string | Optional | sale, rent |
| `category` | string | Optional | all, residential, apartment, house, commercial, land, room |
| `region` | integer | Optional | Any |
| `subarea` | integer | Optional | Any |
| `building_id` | string | Optional | Any |
| `q` | string | Optional | Up to 100 characters |
| `bedrooms` | integer | Optional | Any |
| `bathrooms` | integer | Optional | Any |
| `property_type_id` | integer | Optional | Any |
| `furnished_id` | integer | Optional | 1, 2, 3 |
| `min_price` | integer | Optional | Any |
| `max_price` | integer | Optional | Any |
| `min_size` | integer | Optional | Any |
| `max_size` | integer | Optional | Any |
| `store` | integer | Optional | Any |
| `user_id` | integer | Optional | Any |
| `sort` | string | Optional | latest, price\_asc, price\_desc |
| `page` | integer | Optional | Any |

## Example request

Mudah.my Property

GET /v1/mudah-my-property/search?listing\_type=sale&category=apartment&region=8&bedrooms=3 

```
{
  "success": true,
  "data": {
    "search_parameters": {
      "listing_type": "sale",
      "category": "apartment",
      "region": "8",
      "bedrooms": "3",
      "sort": "latest",
      "page": 1
    },
    "search_metadata": {
      "page": 1,
      "per_page": 40,
      "total_results": 15527,
      "showing": 40,
      "filtered_out": 0,
      "has_next": true,
      "depth_limit_reached": false
    },
    "listings": [
      {
        "list_id": 115312393,
        "ad_id": 135407214,
        "title": "[🌟TKT 1 + FULL LOAN🌟] Mahkota Cheras Flat L4 Pangsapuri Orkid BMC",
        "url": "https://www.mudah.my/tkt-1-full-loan-mahkota-cheras-flat-l4-pangsapuri-orkid-bmc-115312393.htm",
        "listing_type": "sale",
        "category": {
          "id": 2020,
          "name": "Apartment / Condominium"
        },
        "property_type": {
          "id": 2,
          "name": "Apartment"
        },
        "tenure": "Freehold",
        "price": {
          "amount": 140000,
          "currency": "MYR",
          "label": "RM 140,000",
          "old_price": 148000
        },
        "size": {
          "value": 650,
          "unit": "sq.ft."
        },
        "bedrooms": 3,
        "bathrooms": 2,
        "location": {
          "region": "Selangor",
          "region_id": 8,
          "subarea": "Kajang",
          "subarea_id": 298
        },
        "building": {
          "id": "e309ce06-ec70-4fa8-8986-f19b4964109c",
          "name": "Pangsapuri Orkid, Bandar Mahkota Cheras"
        },
        "seller": {
          "user_id": 2843274,
          "name": "TK TAN 019-6302828",
          "store_id": 490304,
          "store_verified": true,
          "type": "agent",
          "company_ad": true
        },
        "images": [
          "https://img.rnudah.com/images/30/3005723162905927509.jpg"
        ],
        "image_count": 7,
        "media_count": 7,
        "dates": {
          "listed_at": "2026-11-12T21:18:49+08:00",
          "original_listed_at": "2026-09-21T11:30:08+08:00",
          "modified_at": "2026-11-12T21:18:49+08:00",
          "expires_at": "2026-11-22T11:30:08+08:00"
        }
      },
      {
        "list_id": 116283364,
        "ad_id": 136557040,
        "title": "LEVEL 1 Apartment Mutiara Bukit Raja 1 Klang",
        "url": "https://www.mudah.my/level-1-apartment-mutiara-bukit-raja-1-klang-116283364.htm",
        "listing_type": "sale",
        "category": {
          "id": 2020,
          "name": "Apartment / Condominium"
        },
        "property_type": {
          "id": 2,
          "name": "Apartment"
        },
        "tenure": "Freehold",
        "price": {
          "amount": 165000,
          "currency": "MYR",
          "label": "RM 165,000"
        },
        "size": {
          "value": 657,
          "unit": "sq.ft."
        },
        "bedrooms": 3,
        "bathrooms": 2,
        "location": {
          "region": "Selangor",
          "region_id": 8,
          "subarea": "Klang",
          "subarea_id": 303
        },
        "building": {
          "id": "3b6e8d73-3639-49cd-a176-564020d73a1a",
          "name": "Mutiara Bukit Raja 2 Apartment"
        },
        "seller": {
          "user_id": 18440990,
          "name": "RAFIQ BIN ROSEMAN",
          "store_id": 1612297,
          "store_verified": false,
          "type": "agent",
          "company_ad": true
        },
        "images": [
          "https://img.rnudah.com/images/30/3010648563765318652.jpg"
        ],
        "image_count": 10,
        "media_count": 10,
        "dates": {
          "listed_at": "2026-11-12T21:10:01+08:00",
          "original_listed_at": "2026-11-12T21:10:01+08:00",
          "modified_at": "2026-11-12T21:10:01+08:00",
          "expires_at": "2027-01-13T21:08:43+08:00"
        }
      },
      {
        "list_id": 116099123,
        "ad_id": 136335471,
        "title": "Pangsapuri Palma Di Bandar Country Homes, Rawang.",
        "url": "https://www.mudah.my/pangsapuri-palma-di-bandar-country-homes-rawang-116099123.htm",
        "listing_type": "sale",
        "category": {
          "id": 2020,
          "name": "Apartment / Condominium"
        },
        "property_type": {
          "id": 2,
          "name": "Apartment"
        },
        "tenure": "Freehold",
        "price": {
          "amount": 90000,
          "currency": "MYR",
          "label": "RM 90,000"
        },
        "size": {
          "value": 645,
          "unit": "sq.ft."
        },
        "bedrooms": 3,
        "bathrooms": 2,
        "location": {
          "region": "Selangor",
          "region_id": 8,
          "subarea": "Rawang",
          "subarea_id": 322
        },
        "building": {
          "id": "4b13e2f0-236a-4049-8855-dedcebdced28",
          "name": "Palma Apartment (Bandar Country Homes)"
        },
        "seller": {
          "user_id": 18893852,
          "name": "Vivian Ho",
          "store_id": 1623297,
          "store_verified": true,
          "type": "agent",
          "company_ad": true
        },
        "images": [
          "https://img.rnudah.com/images/30/3007312838817228466.jpg"
        ],
        "image_count": 8,
        "media_count": 9,
        "dates": {
          "listed_at": "2026-11-12T21:00:07+08:00",
          "original_listed_at": "2026-10-21T07:49:26+08:00",
          "modified_at": "2026-11-12T21:00:07+08:00",
          "expires_at": "2026-12-22T07:49:26+08:00"
        }
      }
    ]
  },
  "meta": {
    "endpoint_family": "search",
    "request_id": "req_2b02131c88414a12a815e443f6b5a0ec",
    "credits_charged": 1,
    "credits_remaining": 1842
  }
}
```

200 OK JSON X-Credits-Used: 1

Recorded from our API and shortened.

[Run this endpoint in the playground](https://perceptlayer.com/apis/mudah-my-property?try=search#playground) with your own parameters. 1 credit per successful call; failed calls are free.
