# Hong Kong Contractor License Lookup & Leads Scraper (BD) (`scrapebench/hong-kong-building-contractor-license-lookup`) Actor

Hong Kong Buildings Department registers in one dataset: 19,677 registered contractors, Authorized Persons, structural and geotechnical engineers and inspectors, with phone, email, fax, district and expiry. Export a register or look up a firm.

- **URL**: https://apify.com/scrapebench/hong-kong-building-contractor-license-lookup.md
- **Developed by:** [ScrapeBench](https://apify.com/scrapebench) (community)
- **Categories:** Lead generation
- **Features:** Limited permissions
- **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$0.004 / registration

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?

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

## Hong Kong Contractor License Lookup & Leads Scraper (BD)

### Pain points

- The Buildings Department publishes its registers behind a disclaimer page and as one mixed file of every register, with one row per Authorized Signatory, so a company appears many times and the file has to be cleaned before it can be used.
- BD's own register search answers one name at a time; there is no list of, say, every Registered General Building Contractor or every Class III minor works firm.
- The registers are spread across 16 registration types (contractors, Authorized Persons, engineers, inspectors) that a buyer has to tell apart.

### What we solve

- Reads the Buildings Department's current registers file in every run: 19,677 registrations on November 16, 2026.
- One clean table: name (English and Chinese), registration number, register, phone, email, fax, district, expiry date, authorized signatories and minor works classes.
- Looks up firm or person names (contained in the name) or registration numbers live in the same file.

### Summary

Hong Kong Buildings Department registers of contractors and building professionals in one dataset: Minor Works Contractors (companies and individuals), General Building Contractors, five Specialist Contractor registers (site formation, ventilation, foundation, demolition, ground investigation), Authorized Persons (architects, surveyors, engineers), Registered Structural and Geotechnical Engineers and Registered Inspectors. Each registration is one row with the name, registration number, register, expiry date and, where the Department lists them, phone, email, fax, district, authorized signatories, minor works classes and building safety services. On November 16, 2026 the registers held 19,677 registrations: a phone filled 13,599 and an email 10,463. The registers carry no street address. Every run reads the Department's current file. Pay only per registration returned.

### Who it's for

- Construction suppliers and subcontractors selling to Hong Kong contractors
- Developers and main contractors vetting a subcontractor's registration and expiry
- Insurers, banks and compliance teams checking a Buildings Department registration number
- Recruiters and consultancies reaching Authorized Persons, engineers and inspectors

### How to use

This actor does two jobs. Run it, then collect results from the run's dataset (export to JSON/CSV/Excel, or pull via the Apify API).

**Get a list (export):** no names, just filters; returns the whole matching list.

```json
{
  "mode": "export",
  "categories": [
    "General Building Contractor"
  ],
  "maxResults": 500
}
```

**Check specific firms (lookup):** put company names or licence numbers in `mode`, `queries`; **Inputs** below says how each is matched.

```json
{
  "mode": "lookup",
  "queries": [
    "GBC 138/98",
    "Gammon"
  ],
  "maxResults": 20
}
```

See **Inputs** below for every available field.

### What you get

One row per record:

| Field | Description |
|---|---|
| `name` | Registrant's English name (company or person); the Chinese name when no English one is listed |
| `listing_id` | Registration number as BD prints it, for example MWC 1706/2013 or GBC 138/98 |
| `category` | The register: Minor Works Contractor, General Building Contractor, a Specialist Contractor register, Authorized Person, Registered Structural or Geotechnical Engineer or Registered Inspector |
| `phone` | Telephone number as printed (about 69% of registrations) |
| `phone_e164` | The first number in +852XXXXXXXX form |
| `email` | Email as printed (about 53% of registrations; General Building and Specialist Contractor rows carry none) |
| `city` | District, listed for Minor Works Contractors only (the other registers publish none) |
| `extras.fax` | Fax number, where listed |
| `extras.expires` | Registration expiry date (ISO) |
| `extras.renewal_pending` | True when BD flags a renewal application: the registration continues past the expiry date |
| `extras.authorized_signatories` | Authorized Signatories of a company, in English |
| `extras.name_zh` | Chinese name |
| `extras.minor_works_classes` | Minor works classes I, II, III held by a Minor Works Contractor |
| `source_url` | The Department's open-data page, tagged with the registration number (no per-registrant page is public) |

Sample:

```json
{
  "listing_id": "GBC 288/99",
  "name": "ACCORD CONSTRUCTION & DECORATION CO",
  "phone": "2384 7538",
  "phone_e164": "+85223847538",
  "country": "HK",
  "region": "Hong Kong",
  "category": "General Building Contractor",
  "categories": [
    "General Building Contractor"
  ],
  "source": "live",
  "source_url": "https://data.gov.hk/en-data/dataset/hk-bd-opendata-registers-of-buildings-department#GBC%20288%2F99",
  "extras": {
    "register": "GBC",
    "holder": "company",
    "name_zh": "\u96c5\u95a3\u5efa\u7bc9\u88dd\u4fee\u5de5\u7a0b\u516c\u53f8",
    "expires": "2027-11-02",
    "building_safety_services": [
      "Removal of unauthorised building works and reinstatement",
      "Maintenance and repair of buildings and drainage"
    ],
    "fax": "2782 6615"
  }
}
```

### Inputs

| Field | Required | Type | Default | Description |
|---|---|---|---|---|
| `mode` | no | string | `"auto"` | export: no names, just filters; returns the whole matching list. lookup / verify: put registrant names (matched if contained in the registrant name) or licence numbers (exact) in 'queries'. auto picks the mode for you. |
| `query` | no | string | — | A registrant's name (or listing number) to look up live. Kept alongside 'queries' for saved tasks. |
| `queries` | no | array | `[]` | A registrant's name (or listing number) to look up live. Several values in one run; combined with 'query'. |
| `district` | no | string | — | Only listings in this district. Kept alongside 'districts' for saved tasks. |
| `districts` | no | array | `[]` | Only listings in this district. Several values in one run; combined with 'district'. |
| `categories` | no | array | `[]` | Only rows from this register (one or more). Available: Authorized Person (Architect), Authorized Person (Engineer), Authorized Person (Surveyor), General Building Contractor, Minor Works Contractor (Company), Minor Works Contractor (Individual), Registered Geotechnical Engineer, Registered Inspector (Architect), Registered Inspector (Engineer), Registered Inspector (Surveyor), Registered Structural Engineer, Specialist Contractor (Demolition), Specialist Contractor (Foundation), Specialist Contractor (Ground Investigation), Specialist Contractor (Site Formation), Specialist Contractor (Ventilation). |
| `licenseTypes` | no | array | `[]` | Same filter as 'Register', under the name every state licence actor takes; the two lists are combined. |
| `expiresAfter` | no | string | — | Only licences expiring on or after this date (YYYY-MM-DD). Licences with no published expiry are left out when set. |
| `expiresBefore` | no | string | — | Only licences expiring on or before this date (YYYY-MM-DD): renewals coming due. |
| `maxResults` | no | integer | `500` | Per query in lookup mode; per run in export mode. |
| `proxyConfiguration` | no | object | `{"useApifyProxy": true}` | Used for every request to the source; Apify datacenter by default. |

### Pricing (Pay Per Event)

You pay per result (`dataset-item`) — **no charge for empty runs**. Example: **1000 registrations** at *$0.004/result* ≈ **$4.00**.

### Use cases

- Sales lists: every Registered General Building Contractor or Minor Works Contractor with phone and email.
- Subcontractor checks: confirm a registration number exists and read its expiry and renewal flag.
- Professional outreach: Authorized Persons, structural and geotechnical engineers and inspectors with contact details.
- Market sizing: count registrations by register and by district.

### Why this actor

- All 16 registers in one run, one row per registration with signatories already folded in.
- Phone and email on most Minor Works and professional registrations.
- Read live from the Department's file on every run, not a stored copy.
- Pay per registration; notices are free.

### Limitations & updates

Covers the registers in the Buildings Department's open-data file (19,677 registrations on 2026-11-16). No street address; the district is listed for Minor Works Contractors only; email is absent on General Building and Specialist Contractor rows. Lookups match English names and registration numbers, not Chinese names. If the Department's download refuses the run, the actor returns a free notice instead of rows. The Department states that the personal data in its registers is published for checking registration under the Buildings Ordinance, and Hong Kong's Personal Data (Privacy) Ordinance applies to its use.

### FAQ

**Where does the data come from?**

The Buildings Department's open-data file of its registers, published on data.gov.hk. Every run downloads the current file.

**Which registers are included?**

Minor Works Contractors (company and individual), General Building Contractors, Specialist Contractors (site formation, ventilation, foundation, demolition, ground investigation), Authorized Persons (architect, surveyor, engineer), Registered Structural and Geotechnical Engineers and Registered Inspectors (architect, engineer, surveyor). Use Licence types to pick some.

**Is there a street address or district?**

No street address. The district is listed for Minor Works Contractors only.

**Can I search by Chinese name?**

Not yet: lookups match the English name or the registration number. The Chinese name is returned in extras.name_zh.

**How do I look up a firm or a registration number?**

Put names or registration numbers in queries and set mode to lookup. A name matches if it is contained in the English name; a number matches exactly.

**How am I charged?**

One event per registration returned. Notices are free.

### Guides & use cases

Written up on **[scrapebench.dev](https://scrapebench.dev)** — the bench that runs and verifies this actor against the live source every night:

- **How-to:** [How to run Hong Kong Contractor License Lookup & Leads Scraper (BD)](https://scrapebench.dev/guides/how-to-hong-kong-building-contractor-license-lookup/)
- **Use case:** [Hong Kong General Building Contractors (BD)](https://scrapebench.dev/use-cases/hong-kong-general-building-contractors/)

More actors, coverage and nightly verification results: **[scrapebench.dev](https://scrapebench.dev)**

### Works with AI assistants (MCP)

Callable as an MCP tool, so Claude, Cursor, VS Code Copilot and other MCP clients can run it directly. Grab the config from the [MCP tab](https://apify.com/scrapebench/hong-kong-building-contractor-license-lookup/api/mcp) on this page — Apify hosts the server and keeps that snippet current, and OAuth signs you in on first connect, so no API token goes in your config file.

Then just ask:

> "List Hong Kong General Building Contractors from the Buildings Department registers with their phone numbers."

That is Licence types General Building Contractor (847 registrations on 2026-11-16). Keep maxResults small on a first call. Runs started this way bill exactly like any other run.

### Data & lawful use

This actor collects publicly available information that the Hong Kong Buildings Department (BD) publishes for public
lookup — licence records, business listings and the contact details professionals list there.
Some of it identifies individuals (sole proprietors, licence holders, agents), so treat any
names, phone numbers and emails in your results as personal data.

When you run this actor, you decide what is collected and what it is used for, so you are the
controller of that data and we act only as your processor (Apify Standard Actor Contract).
You need a lawful basis for your use, must honour opt-out and deletion requests, and must
follow the marketing rules that apply to you (CAN-SPAM, TCPA, GDPR, CCPA and similar).
Don't use the output for unsolicited bulk messaging, for screening covered by the FCRA, or
for anything the source's own terms forbid.

Your results are stored in your own Apify account. We don't keep a copy of your results and
don't sell or share them.

### Disclaimer

This is an independent tool. It is not affiliated with, endorsed by or sponsored by
the Hong Kong Buildings Department (BD). Names and marks are used only to describe the data source. Records are
provided as published by the source and may be out of date or incomplete. For anything
consequential (hiring, a permit, a legal decision), confirm the record with the issuing
agency. You are responsible for making sure your use complies with applicable law and the
source's terms.

### Need help?

Open an issue on this actor's **Issues** tab and we'll respond there. Bug reports, missing
fields and feature requests are all welcome. Guides and examples: [scrapebench.dev](https://scrapebench.dev).

If you are a person named in this data and want your record removed from our copy, email
apify-help@scrapebench.dev; the source agency remains the official record.

Your run may be used to improve our services. If something looks off, or you want this actor to fit your use better, please share your run data with us: [Apify Console → Settings → Security → Share run data with developers](https://console.apify.com/settings/security). It lets us see exactly what went wrong and keep improving the actor.

If this actor saved you time, a short review on its Store page helps other buyers find it.

# Actor input Schema

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

export: no names, just filters; returns the whole matching list. lookup / verify: put registrant names (matched if contained in the registrant name) or licence numbers (exact) in 'queries'. auto picks the mode for you.

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

A registrant's name (or listing number) to look up live. Kept alongside 'queries' for saved tasks.

## `queries` (type: `array`):

A registrant's name (or listing number) to look up live. Several values in one run; combined with 'query'.

## `district` (type: `string`):

Only listings in this district. Kept alongside 'districts' for saved tasks.

## `districts` (type: `array`):

Only listings in this district. Several values in one run; combined with 'district'.

## `categories` (type: `array`):

Only rows from this register (one or more). Available: Authorized Person (Architect), Authorized Person (Engineer), Authorized Person (Surveyor), General Building Contractor, Minor Works Contractor (Company), Minor Works Contractor (Individual), Registered Geotechnical Engineer, Registered Inspector (Architect), Registered Inspector (Engineer), Registered Inspector (Surveyor), Registered Structural Engineer, Specialist Contractor (Demolition), Specialist Contractor (Foundation), Specialist Contractor (Ground Investigation), Specialist Contractor (Site Formation), Specialist Contractor (Ventilation).

## `licenseTypes` (type: `array`):

Same filter as 'Register', under the name every state licence actor takes; the two lists are combined.

## `expiresAfter` (type: `string`):

Only licences expiring on or after this date (YYYY-MM-DD). Licences with no published expiry are left out when set.

## `expiresBefore` (type: `string`):

Only licences expiring on or before this date (YYYY-MM-DD): renewals coming due.

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

Per query in lookup mode; per run in export mode.

## `proxyConfiguration` (type: `object`):

Used for every request to the source; Apify datacenter by default.

## Actor input object example

```json
{
  "mode": "auto",
  "queries": [],
  "districts": [],
  "categories": [],
  "licenseTypes": [],
  "maxResults": 500,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `results` (type: `string`):

One row per business listing; notices are free.

# 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 = {};

// Run the Actor and wait for it to finish
const run = await client.actor("scrapebench/hong-kong-building-contractor-license-lookup").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 = {}

# Run the Actor and wait for it to finish
run = client.actor("scrapebench/hong-kong-building-contractor-license-lookup").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 '{}' |
apify call scrapebench/hong-kong-building-contractor-license-lookup --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,scrapebench/hong-kong-building-contractor-license-lookup"
        }
    }
}
```

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/NcoxRgtQa6y1w3PjS/builds/mnqvP4E2TghnlGoNs/openapi.json
