# iProperty Scraper (`shahidirfan/iproperty-scraper`) Actor Effortlessly scrape Malaysian property listings from iProperty. Extract real estate data, prices, locations, and details automatically. Ideal for market analysis, lead generation, and property research. Fast, reliable, and perfect for Malaysian real estate web scraping. - **URL**: https://apify.com/shahidirfan/iproperty-scraper.md - **Developed by:** [Shahid Irfan](https://apify.com/shahidirfan) (community) - **Categories:** Real estate, Lead generation, Automation - **Stats:** 30 total users, 7 monthly users, 93.0% runs succeeded, 2 bookmarks - **User rating**: 5.00 out of 5 stars ## Pricing from $1.99 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## iProperty Malaysia Property Scraper Extract property listing data from iProperty Malaysia at scale. Collect structured property information such as price, location, bedrooms, bathrooms, agent details, and listing links. Built for market research, lead generation, and real-estate monitoring workflows. ### Features - **Property listings extraction** — Collect listing data from iProperty Malaysia sale or rent result pages. - **Pagination support** — Traverse multiple result pages to gather larger datasets. - **Rich property fields** — Capture pricing, address, area, features, and agent information. - **Dataset-ready output** — Store clean records in Apify Dataset for export and automation. - **Flexible filtering input** — Control locale, listing type, result count, and page depth. ### Use Cases #### Real Estate Market Research Track listing volume, pricing, and location patterns across different areas in Malaysia. Build repeatable market snapshots for trend analysis and investment decisions. #### Lead Generation Pipelines Collect listing URLs and agent details for outreach and sales prospecting. Feed qualified records into CRM, spreadsheet, or enrichment workflows. #### Pricing Intelligence Monitor price movements by area, property type, and listing segment. Compare pricing benchmarks over time for better valuation decisions. #### Property Data Warehousing Create structured datasets for dashboards, BI tools, and internal analytics systems. Standardized fields make downstream analysis faster and more reliable. --- ### Input Parameters | Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | `startUrl` | String | No | `https://www.iproperty.com.my/property-for-sale/` | iProperty listing search URL to scrape | | `listingType` | String | No | `sale` | Listing mode: `sale` or `rent` | | `locale` | String | No | `en` | Locale parameter (`en` or `ms`) | | `isCommercial` | Boolean | No | `false` | Request commercial listings when available | | `results_wanted` | Integer | No | `20` | Maximum number of listings to collect | | `max_pages` | Integer | No | `10` | Maximum number of pages to fetch | | `proxyConfiguration` | Object | No | Apify Proxy | Proxy settings for improved reliability | --- ### Output Data Each dataset item contains: | Field | Type | Description | |-------|------|-------------| | `listing_id` | Number | iProperty listing ID | | `listing_url` | String | Full URL of the property listing | | `localized_title` | String | Listing title text | | `full_address` | String | Property address/location string | | `price` | Number | Numeric listing price | | `price_display` | String | Formatted listing price | | `currency` | String | Currency code (for example `MYR`) | | `price_per_area` | String | Displayed price per area | | `bedrooms` | Number | Number of bedrooms | | `bathrooms` | Number | Number of bathrooms | | `floor_area_sqft` | Number | Floor area in sqft | | `land_area_text` | String | Land area display text | | `property_type` | String | Property type label | | `furnishing` | String | Furnishing status text | | `tenure` | String | Tenure value | | `area` | String | Area/neighborhood | | `district` | String | District | | `region` | String | State/region | | `listing_type` | String | Listing type label | | `recency_text` | String | Listing recency text | | `agent_name` | String | Agent name | | `agent_profile_url` | String | Agent profile URL | | `agent_license` | String | Agent license value | | `agency_name` | String | Agency name | | `photo_count` | Number | Number of listing photos | | `thumbnail_url` | String | Main listing thumbnail image | | `source_page` | Number | Search results page number | | `search_rank` | Number | Rank of the listing in collected output | | `scraped_at` | String | ISO timestamp when scraped | --- ### Usage Examples #### Basic Sale Listings Collect the first 20 sale listings: ```json { "startUrl": "https://www.iproperty.com.my/property-for-sale/", "results_wanted": 20 } ```` #### Deeper Pagination Collect up to 150 listings from more result pages: ```json { "startUrl": "https://www.iproperty.com.my/property-for-sale/", "listingType": "sale", "results_wanted": 150, "max_pages": 10 } ``` #### Rent Listings with Locale Switch Collect rent listings in Bahasa Melayu locale: ```json { "startUrl": "https://www.iproperty.com.my/property-for-rent/", "listingType": "rent", "locale": "ms", "results_wanted": 50, "max_pages": 5 } ``` *** ### Sample Output ```json { "listing_id": 108405023, "listing_url": "https://www.iproperty.com.my/property/sungai-buloh/sale-108405023/", "localized_title": "Semi-Detached House For Sale", "full_address": "Valencia, Sungai Buloh, Selangor", "price": 2450000, "price_display": "RM 2,450,000", "currency": "MYR", "bedrooms": 4, "bathrooms": 5, "property_type": "Semi-Detached House", "area": "Valencia", "district": "Sungai Buloh", "region": "Selangor", "agent_name": "Chanel Lee", "agency_name": "IQI Realty Sdn. Bhd.", "source_page": 1, "search_rank": 1, "scraped_at": "2026-02-20T10:00:00.000Z" } ``` *** ### Tips for Best Results #### Start with Smaller Runs - Use `results_wanted` between `20` and `50` for validation runs. - Increase gradually after confirming output quality. #### Control Page Depth - Use `max_pages` as a safety guard for predictable run duration. - Increase `max_pages` only when you need wider coverage. #### Tune by Use Case - Use `listingType` to separate sale and rent datasets. #### Use Proxy for Stability - Keep `proxyConfiguration` enabled for more reliable data collection. - Residential proxy groups are recommended for consistency on larger runs. *** ### Integrations Connect your dataset with: - **Google Sheets** — Share and analyze listing data quickly. - **Airtable** — Build searchable property databases. - **Make** — Trigger automated property data workflows. - **Zapier** — Connect listing events with your business tools. - **Webhooks** — Push fresh data into custom endpoints. - **Apify API** — Programmatically consume datasets in your apps. #### Export Formats - **JSON** — Best for APIs and custom applications. - **CSV** — Best for spreadsheet workflows. - **Excel** — Best for reporting and stakeholder sharing. - **XML** — Best for legacy or structured integrations. *** ### Frequently Asked Questions #### How many listings can I collect per run? You can collect as many as available, controlled by `results_wanted` and `max_pages`. #### Can I scrape both sale and rent listings? Yes. Set `listingType` to `sale` or `rent`, and use the matching `startUrl`. #### Why are some fields empty on certain records? Some listings may not publish all attributes (for example furnishing or area details). #### Can I start from page 2 or later? By default, runs start from the first available results page. #### Is proxy required? Proxy is not always mandatory for small runs, but it is recommended for better stability and consistency. #### Can I schedule this actor? Yes. You can schedule recurring runs in Apify Console for ongoing monitoring. *** ### Support For issues or feature requests, contact support through the Apify Console. #### Resources - [Apify Documentation](https://docs.apify.com/) - [Apify API Reference](https://docs.apify.com/api/v2) - [Apify Scheduling](https://docs.apify.com/platform/schedules) *** ### Legal Notice This actor is designed for legitimate data collection purposes. Users are responsible for complying with website terms of service, local laws, and data usage regulations. # Actor input Schema ## `startUrl` (type: `string`): Listing search page URL. Example: https://www.iproperty.com.my/property-for-sale/ ## `listingType` (type: `string`): Listing type query value used by iProperty API. ## `locale` (type: `string`): Locale query value used by iProperty API. ## `isCommercial` (type: `boolean`): Set true to request commercial listings when available. ## `results_wanted` (type: `integer`): Maximum number of property records to collect. ## `max_pages` (type: `integer`): Safety cap for how many result pages to fetch. ## `proxyConfiguration` (type: `object`): Use Apify Proxy for stable access. ## Actor input object example ```json { "startUrl": "https://www.iproperty.com.my/property-for-sale/", "listingType": "sale", "locale": "en", "isCommercial": false, "results_wanted": 20, "max_pages": 10, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # Actor output Schema ## `overview` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "startUrl": "https://www.iproperty.com.my/property-for-sale/" }; // Run the Actor and wait for it to finish const run = await client.actor("shahidirfan/iproperty-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "startUrl": "https://www.iproperty.com.my/property-for-sale/" } # Run the Actor and wait for it to finish run = client.actor("shahidirfan/iproperty-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "startUrl": "https://www.iproperty.com.my/property-for-sale/" }' | apify call shahidirfan/iproperty-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=shahidirfan/iproperty-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "iProperty Scraper", "description": "Effortlessly scrape Malaysian property listings from iProperty. Extract real estate data, prices, locations, and details automatically. Ideal for market analysis, lead generation, and property research. Fast, reliable, and perfect for Malaysian real estate web scraping.", "version": "1.0", "x-build-id": "rsffY81Bmj0et8Vfb" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/shahidirfan~iproperty-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-shahidirfan-iproperty-scraper", "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/shahidirfan~iproperty-scraper/runs": { "post": { "operationId": "runs-sync-shahidirfan-iproperty-scraper", "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/shahidirfan~iproperty-scraper/run-sync": { "post": { "operationId": "run-sync-shahidirfan-iproperty-scraper", "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": { "startUrl": { "title": "Start URL", "type": "string", "description": "Listing search page URL. Example: https://www.iproperty.com.my/property-for-sale/" }, "listingType": { "title": "Listing type", "enum": [ "sale", "rent" ], "type": "string", "description": "Listing type query value used by iProperty API.", "default": "sale" }, "locale": { "title": "Locale", "enum": [ "en", "ms" ], "type": "string", "description": "Locale query value used by iProperty API.", "default": "en" }, "isCommercial": { "title": "Commercial listings", "type": "boolean", "description": "Set true to request commercial listings when available.", "default": false }, "results_wanted": { "title": "Maximum number of listings", "minimum": 1, "type": "integer", "description": "Maximum number of property records to collect.", "default": 20 }, "max_pages": { "title": "Maximum pages", "minimum": 1, "type": "integer", "description": "Safety cap for how many result pages to fetch.", "default": 10 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Use Apify Proxy for stable access.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } } ```