Malaysia Property Leads & Listings Scraper

Scrape public Malaysian property listings and lead signals from Mudah.my. The MVP is category/API-first: Mudah category URLs are converted to Mudah public search API requests, while public profile/store URLs can still be used for contact enrichment when available.

What it extracts

• Public Mudah store/profile records
• Public phone numbers and email addresses when present in profile or listing text
• Listing title, URL, ID, price, currency, property type, image, and position
• Store/agent/profile URL fields
• Source status for pages that return bot-protection/challenge pages

Example input

{
  "mode": "urls",
  "startUrls": [
    { "url": "https://www.mudah.my/malaysia/properties-for-sale" },
    { "url": "https://www.mudah.my/malaysia/properties-for-rent" },
    { "url": "https://www.mudah.my/property/apartment" }
  ],
  "maxItems": 20,
  "includeListingDetails": false
}

Optional generated Mudah search pages:

{
  "mode": "auto",
  "transactionType": "sale",
  "regions": ["kuala-lumpur", "selangor"],
  "maxItems": 100,
  "maxPagesPerSearch": 1
}

Notes

• Mudah category pages are the default listing source: /malaysia/properties-for-sale, /malaysia/properties-for-rent, and /property/apartment.
• The actor maps those pages to public Mudah search API combinations:
  • sale: apartment/condominium, house, and new project results
  • rent: apartment/condominium and house results
  • apartment: apartment/condominium sale, rent, and new project results
• If several category URLs are supplied, records are saved until maxItems is reached. Use a focused URL, such as only /malaysia/properties-for-rent, when you want a rent-only dataset.
• Mudah profile pages are useful when you want public contact extraction from a known agent/store profile.
• Some listing detail pages can return a Cloudflare challenge. The actor reports those as sourceStatus: "blocked_or_unavailable" instead of trying to bypass the challenge.
• PropertyGuru Malaysia and iProperty Malaysia are not included in the MVP because direct requests currently return anti-bot/challenge pages.

Output fields

Common fields include:

• recordType
• sourceStatus
• listingId
• profileId
• title
• url
• price
• currency
• location
• agentName
• agencyName
• storeName
• contactPhones
• contactEmail
• contactWhatsapp
• profileUrl
• image
• scrapedAt