# 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:** 37 total users, 3 monthly users, 100.0% runs succeeded, 3 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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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.
- **New project detection** — Identify new development projects alongside resale listings.
- **Developer and award flags** — Distinguish developer listings and award-winning agents.
- **Expanded location data** — Short address and area name fields for better geolocation.

### 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 |
| `short_address` | String | Shortened address |
| `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 |
| `property_subtype` | String | Property sub-type (e.g. "2-storey Terraced House") |
| `furnishing` | String | Furnishing status text |
| `tenure` | String | Tenure value |
| `area_name` | String | Area/neighborhood name |
| `district` | String | District |
| `region` | String | State/region |
| `listing_type` | String | Listing type label |
| `listing_type_code` | String | Listing type code |
| `recency_text` | String | Listing recency text |
| `is_verified` | Boolean | Verified listing flag |
| `is_official_listing` | Boolean | Official listing flag |
| `is_prioritized` | Boolean | Prioritized listing flag |
| `is_new_project` | Boolean | New development project flag |
| `is_developer_listing` | Boolean | Developer direct listing flag |
| `has_award` | Boolean | Agent award flag |
| `developer` | Mixed | Developer name or object |
| `posted_on` | Object | Posted date (text + unix timestamp) |
| `photo_count` | Number | Number of listing photos |
| `thumbnail_url` | String | Main listing thumbnail image |
| `badge_text` | String | Special badge text (e.g. "New Launch") |
| `agent_name` | String | Agent name |
| `agent_profile_url` | String | Agent profile URL |
| `agent_license` | String | Agent license value |
| `agency_name` | String | Agency name |
| `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": 501264671,
  "listing_url": "https://www.iproperty.com.my/property/seri-kembangan/bukit-gita-bayu/sale-501264671/",
  "localized_title": "Bukit Gita Bayu, Seri Kembangan",
  "full_address": "Bukit Gita Bayu, Seri Kembangan, Selangor",
  "short_address": "Bukit Gita Bayu, Seri Kembangan, Selangor",
  "price": 3980000,
  "price_display": "RM 3,980,000",
  "currency": "MYR",
  "bedrooms": 7,
  "bathrooms": 6,
  "property_type": "Bungalow House",
  "property_subtype": "Bungalow House",
  "area_name": "Bukit Gita Bayu",
  "district": "Seri Kembangan",
  "region": "Selangor",
  "listing_type": "For Sale",
  "is_verified": false,
  "is_new_project": false,
  "is_developer_listing": false,
  "agent_name": "Alice Ng",
  "agency_name": "POLYGON PROPERTIES SDN BHD",
  "photo_count": 15,
  "source_page": 1,
  "search_rank": 1,
  "scraped_at": "2026-07-12T07:02:30.925Z"
}
```

***

### 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": 3,
  "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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "startUrl": "https://www.iproperty.com.my/property-for-sale/",
    "listingType": "sale",
    "locale": "en",
    "isCommercial": false,
    "results_wanted": 20,
    "max_pages": 3
};

// 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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "startUrl": "https://www.iproperty.com.my/property-for-sale/",
    "listingType": "sale",
    "locale": "en",
    "isCommercial": False,
    "results_wanted": 20,
    "max_pages": 3,
}

# 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(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).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/",
  "listingType": "sale",
  "locale": "en",
  "isCommercial": false,
  "results_wanted": 20,
  "max_pages": 3
}' |
apify call shahidirfan/iproperty-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,shahidirfan/iproperty-scraper"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/DZc7qrVwXBRKyzpuF/builds/ahalTeoUHtvhbBWzh/openapi.json