# Singapore HDB Resale Scraper — New Transaction Alerts (`magnova/sg-hdb-resale-monitor`) Actor

Search Singapore HDB resale transactions and watch for new sales: official HDB data via data.gov.sg, every resale since 2017 by town, flat type and price. Watch mode delivers only new transactions. Pay per record, no start fee.

- **URL**: https://apify.com/magnova/sg-hdb-resale-monitor.md
- **Developed by:** [Magnova](https://apify.com/magnova) (community)
- **Categories:** Real estate, Automation, Developer tools
- **Features:** Limited permissions, Single-tenant, Server interface
- **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.40 / 1,000 transaction records

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Singapore HDB Resale Scraper — New Transaction Alerts

Search Singapore's official HDB resale transactions, or **watch a town or segment and get told only when new sales appear**.

Every record is a real resale transaction from the Housing & Development Board's official dataset on data.gov.sg — registration month, town, flat type, block, street name, storey range, floor area, flat model, lease commence year, remaining lease, the resale price in SGD and the price per square metre — covering every registration from January 2017 onwards, refreshed daily. Run the same filters in **watch mode** on a schedule and the actor remembers what it has seen: later runs deliver only the transactions that are new.

Built for AI agents and automations: pay per record, no start fee, and a server mode that answers a POST with the records in the response — no run to start, no dataset to poll.

### Two modes

**Search** — returns the newest matching transactions for your filters.

**Watch** — the first run stores the current transactions and returns the newest ones as a baseline. Later runs return only `NEW` transactions. Schedule it daily and you hear about a town again only when a new sale registers. Watch state is kept per filter set (towns + flat types + month range + price range), in a named key-value store in the account running the actor.

### Example input

```json
{
  "towns": ["BEDOK"],
  "flatTypes": ["4 ROOM"],
  "mode": "search",
  "maxResults": 20
}
```

### Example output

One `TRANSACTION` record (a real record from a staging run, trimmed):

```json
{
  "recordType": "TRANSACTION",
  "changeType": "SEARCH",
  "month": "2026-11",
  "town": "BEDOK",
  "flatType": "4 ROOM",
  "block": "63",
  "streetName": "NEW UPP CHANGI RD",
  "storeyRange": "04 TO 06",
  "floorAreaSqm": 92,
  "flatModel": "New Generation",
  "leaseCommenceDate": 1978,
  "remainingLease": "50 years 07 months",
  "resalePrice": 530000,
  "currency": "SGD",
  "pricePerSqm": 5760.87,
  "transactionKey": "2026-11|BEDOK|63|NEW UPP CHANGI RD|4 ROOM|04 TO 06|92.00|530000",
  "source": "HDB resale transactions via data.gov.sg (Singapore Open Data Licence)"
}
```

Each run also ends with a free `SUMMARY` record (matches found, records delivered, watch check count). A failed check produces a free `ERROR` record instead of charging you for nothing.

### Filters

- **towns** — HDB towns as HDB spells them (BEDOK, ANG MO KIO, BUKIT MERAH, PUNGGOL, SENGKANG, TAMPINES, WOODLANDS, YISHUN, …). Empty = all of Singapore.
- **flatTypes** — 1 ROOM, 2 ROOM, 3 ROOM, 4 ROOM, 5 ROOM, EXECUTIVE, MULTI-GENERATION. Empty = all.
- **monthFrom / monthTo** — registration month range as YYYY-MM (dataset starts 2017-01).
- **minPrice / maxPrice** — resale price range in SGD.
- **maxResults** — cap on delivered records per run (1–1000, newest first). In watch mode it caps both the baseline size and the alerts per check; a check scans the newest 1,000 matching transactions for changes.

### Pricing

Pay per event, no start fee. You never pay for ERROR or SUMMARY records.

| Event | What you get | Price (FREE/BRONZE) | SILVER | GOLD and above |
|---|---|---|---|---|
| Transaction record | One transaction record, in search mode or as a watch baseline row | $0.002 | $0.0017 | $0.0014 |
| New transaction alert | One NEW transaction delivered by a watch check | $0.01 | $0.0085 | $0.007 |

`maxTotalChargeUsd` optionally caps a run's total charge.

### Server mode

The actor is server-callable (Apify Standby, single-tenant): POST the same JSON input to the actor's server URL and get `{"records": [...], "summary": {...}}` back in the response — no run to start, no dataset to poll. Watch mode works over the server too; state persists in the caller's own storage, so repeated calls track the same watches. Server requests deliver at most 100 records per request.

### Data source

HDB resale transactions published by Singapore's Housing & Development Board via data.gov.sg ("Resale flat prices based on registration date from Jan-2017 onwards"), under the Singapore Open Data Licence. The data is read from the portal's public datastore — no account, no API key, nothing scraped from a login. Prices are the registered resale prices; HDB notes they should be taken as indicative of the market, since each price is agreed between buyer and seller.

⭐ Finding this useful? A rating on the Apify Store helps other users discover this Actor — thank you!

# Actor input Schema

## `mode` (type: `string`):

Search returns every matching transaction now, newest first. Watch stores the current transactions in the actor's storage: the first watch run returns the newest ones as a baseline, later runs return only transactions that appeared since the previous check. Run watch mode on a schedule (or call the server URL) to track a town or segment.

## `towns` (type: `array`):

HDB towns to include, spelled as HDB spells them (BEDOK, ANG MO KIO, BUKIT MERAH, CLEMENTI, JURONG EAST, PUNGGOL, SENGKANG, TAMPINES, WOODLANDS, YISHUN and the other official towns). Matching is case-insensitive. Leave empty to search all of Singapore.

## `flatTypes` (type: `array`):

Flat types to include: 1 ROOM, 2 ROOM, 3 ROOM, 4 ROOM, 5 ROOM, EXECUTIVE or MULTI-GENERATION. Leave empty to include every flat type.

## `monthFrom` (type: `string`):

Earliest registration month to include, as YYYY-MM. The dataset starts at 2017-01. Leave unset for no lower bound.

## `monthTo` (type: `string`):

Latest registration month to include, as YYYY-MM (cannot be in the future). Leave unset for no upper bound.

## `minPrice` (type: `number`):

Only transactions with a resale price at or above this amount (SGD) are delivered. Leave unset for no minimum.

## `maxPrice` (type: `number`):

Only transactions with a resale price at or below this amount (SGD) are delivered. Leave unset for no maximum.

## `maxResults` (type: `integer`):

Maximum transaction records delivered per run (1-1000), newest first. Extra matching transactions beyond this are not delivered or charged. On a watch's first check this is also the baseline size; later checks deliver at most this many new-transaction alerts.

## `maxTotalChargeUsd` (type: `number`):

Optional hard cap on the total charge for this run, in USD, shared across transaction records and new-transaction alerts. The run stops delivering charged records before the cap would be exceeded; ERROR and SUMMARY records are always free.

## Actor input object example

```json
{
  "mode": "search",
  "towns": [
    "BEDOK"
  ],
  "flatTypes": [
    "4 ROOM"
  ],
  "monthFrom": "2026-01",
  "monthTo": "2026-11",
  "minPrice": 400000,
  "maxPrice": 900000,
  "maxResults": 100,
  "maxTotalChargeUsd": 1
}
```

# Actor output Schema

## `results` (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 = {
    "mode": "search",
    "towns": [
        "BEDOK"
    ],
    "flatTypes": [
        "4 ROOM"
    ],
    "maxResults": 100
};

// Run the Actor and wait for it to finish
const run = await client.actor("magnova/sg-hdb-resale-monitor").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 = {
    "mode": "search",
    "towns": ["BEDOK"],
    "flatTypes": ["4 ROOM"],
    "maxResults": 100,
}

# Run the Actor and wait for it to finish
run = client.actor("magnova/sg-hdb-resale-monitor").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 '{
  "mode": "search",
  "towns": [
    "BEDOK"
  ],
  "flatTypes": [
    "4 ROOM"
  ],
  "maxResults": 100
}' |
apify call magnova/sg-hdb-resale-monitor --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,magnova/sg-hdb-resale-monitor"
        }
    }
}
```

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/daqkDYSFe90nKBJbF/builds/hlBv9YlTic02HodJO/openapi.json
