{ "openapi": "3.0.1", "info": { "title": "Mudah.my Malaysia Listings, Prices & Seller Contacts", "description": "Returns Mudah.my listings as structured records: title, price, location, postDate, description, imageUrls, sellerName, sellerPhone, category attributes. Covers cars, property, phones, jobs, home goods. Input: searchKeywords or categoryUrls. monitorMode emits price-change and new-listing events.", "version": "0.1", "x-build-id": "glNXlf0koCTqBTRq0" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/farside~mudah-lead-radar/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-farside-mudah-lead-radar", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/farside~mudah-lead-radar/runs": { "post": { "operationId": "runs-sync-farside-mudah-lead-radar", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/farside~mudah-lead-radar/run-sync": { "post": { "operationId": "run-sync-farside-mudah-lead-radar", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "searchKeywords": { "title": "Search keywords", "type": "array", "description": "Keywords to search Mudah.my for, one search per keyword. Combine with 'category' and 'state' to narrow the results. Provide this OR 'categoryUrls'.", "items": { "type": "string" } }, "categoryUrls": { "title": "Category or search page URLs", "type": "array", "description": "Mudah.my category or search page URLs to scrape directly, e.g. https://www.mudah.my/selangor/cars-for-sale. Use this instead of 'searchKeywords' when you already know the exact listing pages you want; discovery is skipped and 'category', 'state', 'minPrice', 'maxPrice' and 'sortBy' are ignored.", "items": { "type": "string" } }, "category": { "title": "Category", "enum": [ "all", "cars", "motorcycles", "car-parts", "property-for-sale", "property-for-rent", "rooms-for-rent", "mobile-phones", "computers", "home-appliances", "furniture", "jobs", "services", "fashion", "sports-outdoors", "hobby-collectibles", "pets" ], "type": "string", "description": "Which Mudah.my category to search. 'all' searches every category. Only used with 'searchKeywords'.", "default": "all" }, "state": { "title": "State", "enum": [ "malaysia", "johor", "kedah", "kelantan", "kuala-lumpur", "labuan", "melaka", "negeri-sembilan", "pahang", "penang", "perak", "perlis", "putrajaya", "sabah", "sarawak", "selangor", "terengganu" ], "type": "string", "description": "Malaysian state or federal territory to limit the search to. 'malaysia' searches nationwide. Only used with 'searchKeywords'.", "default": "malaysia" }, "maxListings": { "title": "Maximum listings", "minimum": 1, "maximum": 10000, "type": "integer", "description": "How many listing detail records to capture. Each listing costs one detail page fetch, so this is the main driver of run time and cost.", "default": 100 }, "minPrice": { "title": "Minimum price (MYR)", "minimum": 0, "type": "integer", "description": "Only return listings priced at or above this amount, in Malaysian ringgit. Only used with 'searchKeywords'." }, "maxPrice": { "title": "Maximum price (MYR)", "minimum": 0, "type": "integer", "description": "Only return listings priced at or below this amount, in Malaysian ringgit. Only used with 'searchKeywords'." }, "sortBy": { "title": "Sort results by", "enum": [ "newest", "price_asc", "price_desc" ], "type": "string", "description": "Order Mudah.my returns search results in. 'newest' lists the most recently posted ads first.", "default": "newest" }, "captureSellerContact": { "title": "Capture seller contact details", "type": "boolean", "description": "Include the seller's publicly shown phone and WhatsApp number. Mudah.my publishes these without a login on roughly 78% of listings; the rest offer in-app chat only and are reported as 'not_available'. Turn this off to get listings without personal data.", "default": true }, "monitorMode": { "title": "Monitor for changes", "type": "boolean", "description": "Compare this run against the stored baseline for the same watchlist and emit a change event per difference: price changed, new listing, delisted, relisted, title/description/attributes edited. The first run records a baseline and reports no changes; every run after that reports what moved.", "default": false }, "watchListingIds": { "title": "Listing IDs to watch", "type": "array", "description": "Specific Mudah.my listings to monitor, as listing IDs (115674423) or listing URLs. Turns on monitorMode automatically. Use instead of, or alongside, searchKeywords/categoryUrls when you care about particular listings rather than a standing search.", "items": { "type": "string" } }, "watchlistName": { "title": "Watchlist name", "type": "string", "description": "Names the baseline this run compares against, so you can keep several independent watchlists and can change maxListings without losing your history. Defaults to a name derived from what you are watching." }, "webhookUrl": { "title": "Webhook URL", "type": "string", "description": "HTTP(S) endpoint to POST change events to as they are detected. Sends {source, eventCount, events[]} in batches of 50. Delivery is best-effort: events always land in the dataset even if the webhook is unreachable." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional. Mudah.my serves Apify datacenter IPs normally, so no proxy is needed by default. Enable one only if you see failures from your region.", "default": { "useApifyProxy": false } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } }