# Mudah.my Property Seller Listings API Documentation

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.

- **Documentation:** [https://scrappa.co/docs/mudah-property-api/mudah_property_seller_listings](https://scrappa.co/docs/mudah-property-api/mudah_property_seller_listings) - **API group:** Mudah.my Property API - **Endpoint:** `GET https://scrappa.co/api/mudah-property/v1/seller-listings` ## Authentication Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key. ## Parameters | Parameter | Type | Required | Description | | --- | --- | --- | --- | | `listing_type` | string | No | sale (default) or rent. Example: rent. | | `category` | string | No | residential (default), all, apartment, house, commercial, land or room (room needs rent). Example: apartment. | | `region` | integer | No | State id from autocomplete or the reference route. Example: 8 for Selangor. | | `subarea` | integer | No | Subarea id from autocomplete. Example: 353. | | `building_id` | string | No | Building UUID from autocomplete or the buildings route. | | `q` | string | No | Free text keyword, 2 to 100 characters. Example: freehold. | | `bedrooms` | integer | No | Bedrooms 1 to 5. 5 means 5 or more. Example: 3. | | `bathrooms` | integer | No | Bathrooms 1 to 5. 5 means 5 or more. Example: 2. | | `property_type_id` | integer | No | Property type id from the reference route. Example: 1 for condominium. | | `furnished_id` | integer | No | Rent only. 1 fully, 2 partially, 3 not furnished. Example: 1. | | `min_price` | integer | No | Minimum price in MYR (rent: per month). Example: 300000. | | `max_price` | integer | No | Maximum price in MYR (rent: per month). Example: 500000. | | `min_size` | integer | No | Minimum built-up size in sq.ft. Example: 800. | | `max_size` | integer | No | Maximum built-up size in sq.ft. Example: 1500. | | `user_id` | integer | No | Seller user id from a search item or the agent endpoint. Example: 6690932. Pass user_id or store. | | `store` | integer | No | Seller store id. Pass user_id or store. | | `sort` | string | No | latest (default), price_asc or price_desc. Example: price_asc. | | `page` | integer | No | 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 response ```json { "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 | Status | Error | Description | | --- | --- | --- | | 422 | Validation Error | A required parameter or a value is invalid. This response is not billable. | | 503 | Upstream Unavailable | Mudah.my could not be reached. This response is not billable and is retryable. | | 503 | Unexpected Upstream Data | Mudah.my returned data in an unexpected shape. This response is not billable and is retryable. | ## More Scrappa resources - [API documentation](https://scrappa.co/docs) - [Full LLM-readable API reference](https://scrappa.co/llms-full.txt) - [OpenAPI specification](https://scrappa.co/docs/api.json) - [Pricing](https://scrappa.co/pricing)