Skip to content
Scrappa Get API key
Mudah.my Property API 1 credit/request

Mudah.my Property Seller Listings API Documentation

GET https://scrappa.co/api/mudah-property/v1/seller-listings

Mudah.my Property Seller Listings API returns the ads of one seller or agency with the same listing shape, filters, sort and paging as search. Pass the user_id or store from a search item or from the agent endpoint. Every returned listing belongs to the requested seller.

Mudah.my Property Seller Listings API Documentation 1 credit/request

Endpoint

Request preview
GET
https://scrappa.co/api/mudah-property/v1/seller-listings
Auth header
x-api-key
Cost
1 credit/request
Response preview
200 OK
{
    "data": {
        "listings": [
            {
                "url": "https://www.mudah.my/brand-new-trinity-wellnessa-condominium-pinggiran-ukay-ampang-115015696.htm",
                "size": {
                    "unit": "sq.ft.",
                    "value": 1008
                },
                "ad_id": 135072534,
                "dates": {
                    "listed_at": "2026-10-26T11:57:47+08:00",
                    "expires_at": "2026-11-11T10:49:56+08:00",
                    "modified_at": "2026-10-26T11:57:47+08:00",
...

Parameters

Start with the required fields, then add optional filters only when your use case needs them.

Runnable path

This endpoint has no required query parameters.

18 optional filters available.

listing_type string Optional

sale (default) or rent. Example: rent.

Example value example
category string Optional

residential (default), all, apartment, house, commercial, land or room (room needs rent). Example: apartment.

Example value example
region integer Optional

State id from autocomplete or the reference route. Example: 8 for Selangor.

Example value US
subarea integer Optional

Subarea id from autocomplete. Example: 353.

Example value 10
building_id string Optional

Building UUID from autocomplete or the buildings route.

Example value 1234567890
q string Optional

Free text keyword, 2 to 100 characters. Example: freehold.

Example value coffee shops
bedrooms integer Optional

Bedrooms 1 to 5. 5 means 5 or more. Example: 3.

Example value 10
bathrooms integer Optional

Bathrooms 1 to 5. 5 means 5 or more. Example: 2.

Example value 10
property_type_id integer Optional

Property type id from the reference route. Example: 1 for condominium.

Example value 1234567890
furnished_id integer Optional

Rent only. 1 fully, 2 partially, 3 not furnished. Example: 1.

Example value 1234567890
min_price integer Optional

Minimum price in MYR (rent: per month). Example: 300000.

Example value 10
max_price integer Optional

Maximum price in MYR (rent: per month). Example: 500000.

Example value 10
min_size integer Optional

Minimum built-up size in sq.ft. Example: 800.

Example value 10
max_size integer Optional

Maximum built-up size in sq.ft. Example: 1500.

Example value 10
user_id integer Optional

Seller user id from a search item or the agent endpoint. Example: 6690932. Pass user_id or store.

Example value 1234567890
store integer Optional

Seller store id. Pass user_id or store.

Example value 10
sort string Optional

latest (default), price_asc or price_desc. Example: price_asc.

Example value relevance
page integer Optional

One-based page number. 40 results per page, up to page 250. Later pages return an empty page with depth_limit_reached. Example: 2.

Example value 1

Response Schema

Example response fields are illustrative; inspect the JSON before integrating.

Example response fields

Scan these fields before integrating.

data meta success
JSON Response
200 OK
{
    "data": {
        "listings": [
            {
                "url": "https://www.mudah.my/brand-new-trinity-wellnessa-condominium-pinggiran-ukay-ampang-115015696.htm",
                "size": {
                    "unit": "sq.ft.",
                    "value": 1008
                },
                "ad_id": 135072534,
                "dates": {
                    "listed_at": "2026-10-26T11:57:47+08:00",
                    "expires_at": "2026-11-11T10:49:56+08:00",
                    "modified_at": "2026-10-26T11:57:47+08:00",
                    "original_listed_at": "2026-09-10T10:49:56+08:00"
                },
                "price": {
                    "label": "RM 650,000",
                    "amount": 650000,
                    "period": null,
                    "currency": "MYR",
                    "old_price": null
                },
                "title": "Brand New Trinity Wellnessa Condominium Pinggiran Ukay Ampang",
                "images": [
                    "https://img.rnudah.com/images/29/2988873644147707589.jpg"
                ],
                "seller": {
                    "name": "M.J. Zairin",
                    "type": "agent",
                    "user_id": 6690932,
                    "store_id": 790734,
                    "company_ad": true,
                    "store_verified": true
                },
                "tenure": "Freehold",
                "list_id": 115015696,
                "bedrooms": 3,
                "building": {
                    "id": "8b5e379e-b69d-4d4c-a9a6-200f7ae06ae1",
                    "name": "Trinity Wellnessa"
                },
                "category": {
                    "id": 2020,
                    "name": "Apartment / Condominium"
                },
                "location": {
                    "region": "Selangor",
                    "subarea": "Ampang",
                    "region_id": 8,
                    "subarea_id": 268
                },
                "bathrooms": 2,
                "furnished": null,
                "image_count": 44,
                "media_count": 44,
                "listing_type": "sale",
                "property_type": {
                    "id": 1,
                    "name": "Condominium"
                }
            },
            {
                "url": "https://www.mudah.my/corner-unit-fera-residence-wangsa-maju-115015484.htm",
                "size": {
                    "unit": "sq.ft.",
                    "value": 853
                },
                "ad_id": 135072271,
                "dates": {
                    "listed_at": "2026-10-26T11:37:25+08:00",
                    "expires_at": "2026-11-11T10:48:27+08:00",
                    "modified_at": "2026-10-26T11:37:25+08:00",
                    "original_listed_at": "2026-09-10T10:48:27+08:00"
                },
                "price": {
                    "label": "RM 650,000",
                    "amount": 650000,
                    "period": null,
                    "currency": "MYR",
                    "old_price": null
                },
                "title": "Corner Unit Fera Residence Wangsa Maju",
                "images": [
                    "https://img.rnudah.com/images/29/2988871958779563717.jpg"
                ],
                "seller": {
                    "name": "M.J. Zairin",
                    "type": "agent",
                    "user_id": 6690932,
                    "store_id": 790734,
                    "company_ad": true,
                    "store_verified": true
                },
                "tenure": "Freehold",
                "list_id": 115015484,
                "bedrooms": 3,
                "building": {
                    "id": "ce196c14-76a1-4559-8ecf-b818bf6b19bd",
                    "name": "Fera Residence @ The Quartz, Wangsa Maju"
                },
                "category": {
                    "id": 2020,
                    "name": "Apartment / Condominium"
                },
                "location": {
                    "region": "Kuala Lumpur",
                    "subarea": "Wangsa Maju",
                    "region_id": 9,
                    "subarea_id": 408
                },
                "bathrooms": 2,
                "furnished": null,
                "image_count": 29,
                "media_count": 29,
                "listing_type": "sale",
                "property_type": {
                    "id": 5,
                    "name": "Service Residence"
                }
            }
        ],
        "search_metadata": {
            "page": 1,
            "showing": 40,
            "has_next": true,
            "per_page": 40,
            "filtered_out": 0,
            "total_results": 300,
            "depth_limit_reached": false
        },
        "search_parameters": {
            "page": 1,
            "sort": "latest",
            "user_id": 6690932,
            "category": "residential",
            "listing_type": "sale"
        }
    },
    "meta": {
        "billable": true,
        "endpoint_family": "seller_listings"
    },
    "success": true
}

Errors

Handle these documented responses before retrying or showing customer-facing failures.

422

Validation Error

A required parameter or a value is invalid. This response is not billable.

{
    "errors": {
        "field": [
            "The field is invalid."
        ]
    },
    "message": "The request validation failed"
}
503

Upstream Unavailable

Mudah.my could not be reached. This response is not billable and is retryable.

{
    "meta": {
        "billable": false,
        "retryable": true,
        "endpoint_family": "seller_listings"
    },
    "error": {
        "code": "UPSTREAM_UNAVAILABLE",
        "message": "Mudah.my could not be reached. Please retry shortly."
    },
    "success": false
}
503

Unexpected Upstream Data

Mudah.my returned data in an unexpected shape. This response is not billable and is retryable.

{
    "meta": {
        "billable": false,
        "retryable": true,
        "endpoint_family": "seller_listings"
    },
    "error": {
        "code": "INVALID_UPSTREAM_SHAPE",
        "message": "Mudah.my returned data in an unexpected shape. Please retry shortly."
    },
    "success": false
}

Generate Code with AI

Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.

Try It Live

Test this endpoint in our interactive playground with real data.