Sign inGet a free API keyDashboard
Menu

APIs / Real estate / Mudah.my Property

1 credit per call9 endpoints19 datapoints

Mudah.my Property API

Mudah.my Property API for Malaysian homes, rooms, land and commercial property for sale or rent, listings, buildings and agents. 1 credit per successful call.

Get a free API keyRun it below
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 OKJSONX-Credits-Used: 1
Recorded from our API and shortened.

Sample data

What one call returns

A recorded run of search: the fields and shapes you will get, shortened to 3 items.

#list_idintegerad_idintegertitlestringurlurllisting_typestringcategoryobjectproperty_typeobjecttenurestringpriceobjectsizeobjectbedroomsintegerbathroomsintegerlocationobjectbuildingobjectsellerobjectimagesstring[]image_countintegermedia_countintegerdatesobject
1115312393135407214[🌟TKT 1 + FULL LOAN🌟] Mahkota Cheras Flat L4 Pangsapuri Orkid BMChttps://www.mudah.my/tkt-1-full-loan-mahkota-cheras-flat-l4-pangsapuri-orkid-bmc-115312393.htmsale{2 fields}{2 fields}Freehold{4 fields}{2 fields}32{4 fields}{2 fields}{6 fields}[1 item]77{4 fields}
2116283364136557040LEVEL 1 Apartment Mutiara Bukit Raja 1 Klanghttps://www.mudah.my/level-1-apartment-mutiara-bukit-raja-1-klang-116283364.htmsale{2 fields}{2 fields}Freehold{3 fields}{2 fields}32{4 fields}{2 fields}{6 fields}[1 item]1010{4 fields}
3116099123136335471Pangsapuri Palma Di Bandar Country Homes, Rawang.https://www.mudah.my/pangsapuri-palma-di-bandar-country-homes-rawang-116099123.htmsale{2 fields}{2 fields}Freehold{3 fields}{2 fields}32{4 fields}{2 fields}{6 fields}[1 item]89{4 fields}

Recorded from our API · 3 items shown · 19 datapoints per itemGET /v1/mudah-my-property/search?listing_type=sale&category=apartment&region=8&bedrooms=3

19 datapoints

Identity

  • list_idinteger
  • ad_idinteger
  • titlestring
  • listing_typestring
  • categoryobject
  • property_typeobject

Contact

  • urlurl
  • sellerobject

Location

  • locationobject

Reputation

  • imagesstring[]
  • image_countinteger

Price

  • priceobject

Other

  • tenurestring
  • sizeobject
  • bedroomsinteger
  • bathroomsinteger
  • buildingobject
  • media_countinteger
  • datesobject

Playground

Run this API

cURLshell
curl "https://api.perceptlayer.com/v1/mudah-my-property/search?listing_type=sale&category=apartment&region=8&bedrooms=3" \
  -H "X-API-Key: $API_KEY"

Mudah.my Property · 9 endpoints

Endpoints

Every endpoint takes the same key. Open one for its parameters and an example request.

EndpointRequired parametersCost
GET/v1/mudah-my-property/agent
slug
1 credit
GET/v1/mudah-my-property/autocomplete
keyword+2 optional
1 credit
GET/v1/mudah-my-property/building
prop_id
1 credit
GET/v1/mudah-my-property/buildings
keyword+1 optional
1 credit
GET/v1/mudah-my-property/count
none+16 optional
1 credit
GET/v1/mudah-my-property/listing
list_id
1 credit
GET/v1/mudah-my-property/reference
none
1 credit
GET/v1/mudah-my-property/search
none+18 optional
1 credit
GET/v1/mudah-my-property/seller-listings
none+18 optional
1 credit

Overview

What you can get

The Mudah.my Property API returns Mudah.my property data as JSON through 9 endpoints.

  • Search: search takes a listing_type (sale or rent) and category (all, residential, apartment, house, commercial, land or room), with region, subarea, building_id, q, bedrooms, bathrooms, property_type_id, furnished_id (1, 2 or 3), min_price, max_price, min_size, max_size, store, user_id, sort (latest, price_asc or price_desc) and page. count takes the same filters without sort and page.
  • Listings: listing takes a list_id.
  • Buildings: buildings takes a keyword, with page; building takes a prop_id.
  • Sellers: agent takes a slug; seller-listings takes a user_id with the same filters as search.
  • Lookups: autocomplete takes a keyword, with type (location or keyword) and listing_type; reference takes no parameters.

The recorded search for apartments for sale in region 8 (Selangor in the response) with 3 bedrooms returns search_metadata with a total_results of 15,527, per_page and has_next. Each item in listings carries list_id, ad_id, title, url, listing_type, category, property_type, tenure, price (with old_price when it has changed), size, bedrooms, bathrooms, location (region and subarea), building, seller, image_count and dates.

How a call works

Search a region: GET /v1/mudah-my-property/search?listing_type=sale&category=apartment&region=8&bedrooms=3 with your key in the X-API-Key header. Each listing's list_id is what listing takes, and its seller.user_id is what seller-listings takes as user_id. Every successful call costs 1 credit; failed calls cost nothing.

Real estateJSONRESTMCP

More real estate APIs

28Hse4zida59199.co99acresAdondevivirApartment ListApartments.comAqarAqarmapArgenpropathome

Use cases

Track apartment prices and rents in Selangor and other Malaysian regions

Use the Mudah.my Property API to track apartment prices and rents in Selangor and other Malaysian regions

Spot price cuts from `price.old_price`

Use the Mudah.my Property API to spot price cuts from `price.old_price`

Count listings for a filter set with `count`, without paging through results

Use the Mudah.my Property API to count listings for a filter set with `count`, without paging through results

Follow the listings in one condominium with `building_id`

Use the Mudah.my Property API to follow the listings in one condominium with `building_id`

FAQ

Questions

How much does the Mudah.my Property API cost?

Each successful call costs one credit. New accounts get free credits to start, and credit packs bring the price down as you scale.

What format are responses in?

Every endpoint returns JSON, with no HTML parsing on your side.

Do I need a Mudah.my account?

No. You call this Mudah.my Property API with your Perceptlayer key in the `X-API-Key` header, with no Mudah.my login.

How do I find region and building ids?

Each listing's `location` carries a `region_id` and `subarea_id`, the values `region` and `subarea` take; region 8 is Selangor in the recorded search. `buildings` finds buildings by `keyword`.

Should I build a Mudah.my Property scraper instead?

You can, but a Mudah.my Property scraper is code you maintain: page changes break it, requests get blocked, and Mudah.my Property's terms govern how you collect data. The Mudah.my Property API gives you 9 endpoints of named JSON fields for 1 credit per successful call, and failed calls cost nothing. A scraper makes sense only for data these endpoints don't return, so check the response in the playground on this page first.

Try the Mudah.my Property API with 100 free credits

No credit card. Failed calls are never billed.

Get a free API keyRead the docs