# HDB Renovation Emails · Singapore Contractors (`corent1robert/sg-hdb-renovation-contractor-leads`) Actor

Export Singapore HDB renovation contractors with every published firm email and phone from the official Housing & Development Board directory. Public open data — no login.

- **URL**: https://apify.com/corent1robert/sg-hdb-renovation-contractor-leads.md
- **Developed by:** [Corentin Robert](https://apify.com/corent1robert) (community)
- **Categories:** Lead generation, Automation, Business
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.49 / 1,000 contractor with emails

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

## HDB Renovation Emails · Singapore Contractors

Export **Singapore HDB renovation contractors** with the **email and phone printed** on the official [Housing & Development Board renovation contractor directory](https://data.gov.sg/datasets/d_9973d2c119ed4dd1560aebf8f0829b86/view). One row per contractor. Public open data — no login.

**No login. No API key. No HDB account.**

### Who is this for?

| You are… | Typical goal | Suggested setup |
|----------|--------------|-----------------|
| Fit-out / materials supplier | HDB contractor mailboxes | Leave search blank, only with email |
| Home-services SDR | Named contractors | Company name `DESIGN` |
| Agency / lead list builder | Full official catalogue | Max contractors 0 after a paid upgrade |
| First-run QA | Small CRM sample | 20-row sample |

**What you get by default.** Company name, UEN, HDB directory reference, address, postal code, published mailbox, phone.

**Honest coverage.** The official directory reported **2,708** contractors on 7 Sep 2026. That dump was **2,708/2,708 emails** and **2,707/2,708 phones**. Empty-contact rows are skipped when **Only with email or phone** is on. Contacts are never invented.

A generic data.gov.sg Store actor can dump any resource id — it does **not** price or label this as outreach-ready HDB contractor emails.

### Quick start

1. Open the Actor. Leave **Company name** blank for the full directory, or type a name.
2. Keep **Only with email or phone** on.
3. Leave **Max unique contractors** at 50 for a first paid-style run, or 20 on the free plan.
4. Click **Start**. Download JSON, CSV or Excel.

### Ready-made examples (published tasks)

Landing pages go live when you publish each task from Console (see `published-tasks/publication-console.md`). Until then, use the saved task inputs in `published-tasks/inputs/`.

| Example | Best for |
|---------|----------|
| HDB renovation contractor emails | Contractors that publish a mailbox |
| HDB renovation contractor sample | 20-row try |
| HDB Design renovation contractors | Proven name search |
| HDB Singapore renovation emails | Full-directory first 100 |

### What it extracts

| Category | Fields |
|----------|--------|
| Identity | Company name, UEN, HDB directory reference |
| Contact | Email (never invented), phone |
| Location | Address, postal code |
| Provenance | Official directory URL, data.gov.sg resource id, country `SG` |

### Input

| Field | Meaning |
|-------|---------|
| `query` | Optional company search on the official directory. Leave blank for the full catalogue |
| `onlyWithContact` | Skip rows with no email and no phone. Default on |
| `requireEmail` | Keep only contractors with a published mailbox |
| `requirePhone` | Keep only contractors with a published phone |
| `maxItems` | Unique contractors. **0** = no numerical cap. **Free plan: 20 / run** |

The full official catalogue is about **2,700** contractors. Set `maxItems` unless you want the entire directory.

### Output example

```json
{
  "providerKey": "SGHDB-1",
  "firmId": 1,
  "firmName": "CHUAN TONG TRADING CO",
  "uen": "28713000B",
  "directoryRefNo": "HB-01-0014E",
  "address": "BLK 72 Tagore Lane Sindo Industrial Estate",
  "postalCode": "787497",
  "phone": "66658311",
  "email": "CTGPL@HOTMAIL.COM",
  "contactEmail": "CTGPL@HOTMAIL.COM",
  "contactPhone": "66658311",
  "sourceUrl": "https://data.gov.sg/datasets/d_9973d2c119ed4dd1560aebf8f0829b86/view",
  "resourceId": "d_9973d2c119ed4dd1560aebf8f0829b86",
  "countryCode": "SG"
}
```

Download in JSON, CSV, Excel, or HTML from the Dataset tab.

### How to use HDB renovation contractor emails

1. Open the Actor Input tab
2. Leave **Company name** empty, or type a name such as `DESIGN`
3. Keep **Only with email or phone** on
4. Set **Max unique contractors**
5. Click Start
6. Download results from the Dataset tab

Duplicate contractor ids are **merged** into one CRM row. Emails come from the official HDB directory, never invented.

### How much does it cost to scrape HDB renovation contractors?

Pay-per-event. Actor start is **$0.00005**. A contractor **with email** is **$0.00399** on the free pricing tier (lower on paid Apify tiers). Phone-only and no-contact rows cost less.

| Scenario | FREE | Bronze | Silver | Gold |
|----------|------|--------|--------|------|
| 20 contractors with email | ~$0.08 | ~$0.07 | ~$0.06 | ~$0.05 |
| 1,000 contractors with email | ~$4.04 | ~$3.54 | ~$3.04 | ~$2.54 |
| Full directory (~2,708 emails) | ~$10.81 | ~$9.45 | ~$8.10 | ~$6.74 |

HTTP-only — compute stays small. Free Apify plan: **20 contractors per run**.

### Is it legal to scrape the HDB renovation contractor directory?

This Actor only reads **public** contractor fields that HDB already publishes through [data.gov.sg](https://data.gov.sg/datasets/d_9973d2c119ed4dd1560aebf8f0829b86/view). No login is used.

Treat names, emails, phones and addresses as personal data under Singapore’s **Personal Data Protection Act (PDPA)**. **Do not** buy or run this Actor to send unsolicited direct marketing unless you have a lawful basis (for example consent, or another PDPA exception that applies to your use). Your use must also comply with the HDB / data.gov.sg terms and the Spam Control Act where relevant.

### Also available

**[SG Architect Firm Emails · BOA Register](https://apify.com/corent1robert/sg-boa-architect-firm-leads)** — official Board of Architects firm mailboxes.

**[Singapore Lawyer Emails · Official Law Society](https://apify.com/corent1robert/sg-lawsociety-lawyer-leads)** — featured Singapore Find a Lawyer firms.

**[NSW Solicitor Emails · Law Society Register](https://apify.com/corent1robert/nsw-lawsociety-solicitor-leads)** — New South Wales Register of Solicitors.

### Local development

```bash
npm install

cp input.json storage/key_value_stores/default/INPUT.json
apify run --purge
```

Example `input.json`:

```json
{
  "onlyWithContact": true,
  "maxItems": 20
}
```

Use `apify run` to test locally (not `npm start`). Local `storage/` is not uploaded to Console.

### Support

Contact <corentin@outreacher.fr> if you need a custom scraper or tailored automation.

Ready? Leave the company name blank or type `DESIGN`, keep only-with-contact on, and click Start.

# Changelog

This Actor's version history is a separate document: https://apify.com/corent1robert/sg-hdb-renovation-contractor-leads/changelog.md

# Actor input Schema

## `query` (type: `string`):

Optional search on the official HDB renovation contractor directory (name, address, email). Leave blank for the full catalogue.

## `onlyWithContact` (type: `boolean`):

Skip contractors with neither a published email nor a published phone.

## `requireEmail` (type: `boolean`):

Keep contractors that publish an email address.

## `requirePhone` (type: `boolean`):

Keep contractors that publish a phone number.

## `maxItems` (type: `integer`):

Stop after this many unique contractors. **0 = no numerical cap** — the full official directory is about 2,700 rows.

## Actor input object example

```json
{
  "onlyWithContact": true,
  "requireEmail": false,
  "requirePhone": false,
  "maxItems": 50
}
```

# Actor output Schema

## `dataset` (type: `string`):

All exported unique Singapore HDB renovation contractors.

## `overview` (type: `string`):

Contractor, email, phone and address.

## `contacts` (type: `string`):

Email, phone and UEN.

## `runLog` (type: `string`):

Plain-text progress for this run.

# 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 = {
    "maxItems": 50
};

// Run the Actor and wait for it to finish
const run = await client.actor("corent1robert/sg-hdb-renovation-contractor-leads").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 = { "maxItems": 50 }

# Run the Actor and wait for it to finish
run = client.actor("corent1robert/sg-hdb-renovation-contractor-leads").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 '{
  "maxItems": 50
}' |
apify call corent1robert/sg-hdb-renovation-contractor-leads --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,corent1robert/sg-hdb-renovation-contractor-leads"
        }
    }
}
```

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/zOtzhr7je1cMa4vtq/builds/a16EJNy7slpfBwiv9/openapi.json