# Singapore BCA Registered Contractors Scraper (`automation-lab/singapore-bca-registered-contractors-scraper`) Actor Export registered Singapore BCA contractors from data.gov.sg by workhead, grade, UEN, expiry, address, postal code, and phone. - **URL**: https://apify.com/automation-lab/singapore-bca-registered-contractors-scraper.md - **Developed by:** [Stas Persiianenko](https://apify.com/automation-lab) (community) - **Categories:** Business - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per event This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. 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 ## Singapore BCA Registered Contractors Scraper Export registered Singapore Building and Construction Authority (BCA) contractors from the official data.gov.sg dataset. The actor returns one row per company, workhead, and grade registration, including UEN, expiry date, address, postal code, phone number, and source metadata. Use it when you need a repeatable, API-friendly contractor list for vendor sourcing, compliance checks, procurement enrichment, or market research in Singapore's construction sector. ### What does Singapore BCA Registered Contractors Scraper do? This actor reads the public `Listing of Registered Contractors` dataset from data.gov.sg and saves normalized contractor records to an Apify dataset. It supports: - ๐Ÿ—๏ธ BCA workhead filtering such as `CR06`, `CW01`, `ME01`, or `FM02` - ๐Ÿ“Š Grade filtering such as `L1`, `L2`, `C1`, or `A1` - ๐Ÿงพ UEN/company registration lookups - ๐Ÿข Company name search - ๐Ÿ“… Expiry date filtering - ๐Ÿ“ Clean address assembly into `fullAddress` - ๐Ÿ” Pagination via offset for larger exports ### Who is it for? #### Procurement and vendor sourcing teams Find contractors registered for a specific BCA workhead and grade before inviting bids or issuing RFQs. #### Compliance and risk teams Verify that a contractor appears in the public BCA list, inspect expiry dates, and keep evidence in a structured dataset. #### Construction suppliers and distributors Build lead lists of Singapore contractors by workhead, grade, address, postal code, and phone number. #### Data teams Automate recurring contractor-data snapshots without maintaining CKAN/data.gov.sg API code in-house. ### Why use this actor? The source API is public, but raw records use source-specific field names and require pagination, filters, and normalization. This actor packages those steps into a simple Apify workflow with typed output, charging, examples, and integrations. ### Data source The actor uses Singapore data.gov.sg's public CKAN-style datastore API. - Source: data.gov.sg - Agency: Building and Construction Authority - Dataset: Listing of Registered Contractors - Resource ID: `d_dcda79be4aded5f9e769b8e23ff69b47` - Authentication: none required ### Output data Each dataset item represents one BCA contractor registration row. | Field | Description | | --- | --- | | `companyName` | Registered company name | | `uen` | Singapore UEN / registration number | | `workhead` | BCA workhead code | | `grade` | BCA grade | | `additionalInfo` | Source additional info when present | | `expiryDate` | Registration expiry date as published | | `buildingNo` | Building number | | `streetName` | Street name | | `unitNo` | Unit number | | `buildingName` | Building name | | `postalCode` | Singapore postal code | | `telephone` | Published telephone number | | `fullAddress` | Normalized joined address | | `sourceRecordId` | Source `_id` | | `sourceDatasetId` | data.gov.sg resource ID | | `sourceUrl` | API URL used for the record page | | `scrapedAt` | ISO timestamp for the actor run | ### Example output ```json { "companyName": "#1 DESIGN STUDIO PTE. LTD.", "uen": "201925566H", "workhead": "CR06", "grade": "L1", "additionalInfo": null, "expiryDate": "01/02/2028", "buildingNo": "1085", "streetName": "EUNOS AVENUE 7A", "unitNo": "#03-10", "buildingName": "EUNOS INDUSTRIAL ESTATE", "postalCode": "409535", "telephone": "84885022", "fullAddress": "1085, EUNOS AVENUE 7A, #03-10, EUNOS INDUSTRIAL ESTATE, 409535", "sourceRecordId": 1, "sourceDatasetId": "d_dcda79be4aded5f9e769b8e23ff69b47", "sourceUrl": "https://data.gov.sg/api/action/datastore_search?...", "scrapedAt": "2026-07-03T00:00:00.000Z" } ```` ### How much does it cost to scrape Singapore BCA registered contractors? This actor uses pay-per-event pricing: - Start event: `$0.005` per run - Contractor record event: tiered per saved contractor registration row - Bronze reference price: `$0.000026617` per record before platform tier discounts Apify shows the final price for your plan before you start a run. ### Input options | Input | Type | Default | Description | | --- | --- | --- | --- | | `maxItems` | integer | `20` | Maximum contractor registration rows to save | | `offset` | integer | `0` | Source pagination offset | | `workhead` | string | `CR06` | Exact BCA workhead code | | `grade` | string | `L1` | Exact BCA grade | | `companyName` | string | empty | Full-text company-name search | | `uen` | string | empty | Full-text UEN search | | `expiryDate` | string | empty | Exact expiry date in `DD/MM/YYYY` format | ### Example input: CR06 L1 contractors ```json { "maxItems": 100, "offset": 0, "workhead": "CR06", "grade": "L1" } ``` ### Example input: company lookup ```json { "maxItems": 20, "companyName": "DESIGN" } ``` ### Example input: UEN lookup ```json { "maxItems": 10, "uen": "201925566H" } ``` ### How to run it 1. Open the actor on Apify. 2. Enter the workhead, grade, company, UEN, or expiry-date filter you need. 3. Set `maxItems` to the number of rows you want. 4. Start the run. 5. Download the dataset as JSON, CSV, Excel, or connect it to an integration. ### Tips for better results - Use exact `workhead` and `grade` filters when building procurement lists. - Leave filters empty if you need a broad export from the official dataset. - Use `offset` to continue from a previous run without re-exporting the first rows. - Keep `maxItems` small for testing, then increase it for production exports. - Treat `expiryDate` as an exact source string in `DD/MM/YYYY` format. ### Integrations Use this actor with: - Google Sheets for vendor-review spreadsheets - Airtable for contractor CRM workflows - Zapier or Make for compliance alerts - Data warehouses for periodic Singapore construction-market snapshots - Internal procurement dashboards for RFQ candidate lists ### API usage with Node.js ```js import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: process.env.APIFY_TOKEN }); const run = await client.actor('automation-lab/singapore-bca-registered-contractors-scraper').call({ maxItems: 100, workhead: 'CR06', grade: 'L1' }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(items); ``` ### API usage with Python ```python from apify_client import ApifyClient client = ApifyClient('APIFY_TOKEN') run = client.actor('automation-lab/singapore-bca-registered-contractors-scraper').call(run_input={ 'maxItems': 100, 'workhead': 'CR06', 'grade': 'L1', }) items = client.dataset(run['defaultDatasetId']).list_items().items print(items) ``` ### API usage with cURL ```bash curl -X POST "https://api.apify.com/v2/acts/automation-lab~singapore-bca-registered-contractors-scraper/runs?token=$APIFY_TOKEN" \ -H 'Content-Type: application/json' \ -d '{"maxItems":100,"workhead":"CR06","grade":"L1"}' ``` ### MCP: use from Claude and other assistants You can expose this actor through Apify MCP tools. Claude Desktop configuration: ```json { "mcpServers": { "apify": { "command": "npx", "args": ["-y", "@apify/actors-mcp-server", "--actors", "automation-lab/singapore-bca-registered-contractors-scraper"] } } } ``` MCP URL pattern: ```text https://mcp.apify.com/?tools=automation-lab/singapore-bca-registered-contractors-scraper ``` Claude Code CLI setup: ```bash claude mcp add --transport http apify-bca-contractors "https://mcp.apify.com/?tools=automation-lab/singapore-bca-registered-contractors-scraper" ``` Example prompts for MCP usage: - "Use the Singapore BCA Registered Contractors Scraper to find 100 CR06 L1 contractors and summarize their postal-code distribution." - "Use this MCP tool to check whether UEN 201925566H appears in the BCA registered contractors dataset." - "Run the BCA contractors scraper for ME01 contractors and prepare a supplier shortlist spreadsheet." ### Reliability The actor uses a public JSON API rather than browser automation. No proxy is required, and anti-bot risk is low. If data.gov.sg is temporarily unavailable, retry the run later. ### Data freshness The actor returns the dataset as published by data.gov.sg at run time. It does not independently validate whether BCA has updated the upstream dataset that day. ### Limitations - It returns public dataset rows, not private licensing documents. - It does not enrich records with websites, emails, or directors. - `companyName` and `uen` use source API full-text search behavior. - `expiryDate` is an exact string filter. ### Legality This actor accesses a public government open-data API and returns the public fields published there. Users remain responsible for using the data lawfully, respecting privacy obligations, and following applicable procurement or compliance rules. ### Is it legal to scrape Singapore BCA registered contractors? Yes, the actor uses the official public data.gov.sg API for a public BCA dataset. Users should still apply the data only for lawful sourcing, compliance, and research workflows. ### FAQ #### Does this actor require a data.gov.sg API key? No. The dataset endpoint is public and works without authentication. #### Can I export all contractors? Yes. Leave filters empty and set `maxItems` high enough, or use `offset` across multiple runs. #### Why did I get fewer rows than expected? Your filters may be too narrow, or the source dataset may contain fewer matching rows than `maxItems`. #### Does one company appear multiple times? Yes. The output keeps one row per company/workhead/grade registration because the same company can have multiple BCA registrations. ### Troubleshooting If a run returns no items, remove filters and run a small test with only `maxItems`. If that works, add filters back one at a time. If the source API returns an error, check the run logs for the exact HTTP status and retry later. ### Related scrapers - https://apify.com/automation-lab/singapore-gebiz-contracts-scraper - https://apify.com/automation-lab/website-contact-finder - https://apify.com/automation-lab/company-website-finder ### Changelog #### 0.1 Initial version for the Singapore BCA registered contractors data.gov.sg dataset. # Actor input Schema ## `maxItems` (type: `integer`): Maximum contractor registration rows to save. Each row represents one company/workhead/grade registration. ## `offset` (type: `integer`): Dataset pagination offset. Use 0 for the first page or a higher number to resume a previous export. ## `workhead` (type: `string`): Exact BCA workhead code, for example CR06, CW01, ME01, or FM02. ## `grade` (type: `string`): Exact BCA registration grade, for example L1, L2, C1, or A1. ## `companyName` (type: `string`): Optional full-text search term for contractor company names. ## `uen` (type: `string`): Optional full-text search term for a Singapore UEN / company registration number. ## `expiryDate` (type: `string`): Optional exact BCA expiry date in DD/MM/YYYY format, for example 01/02/2028. ## Actor input object example ```json { "maxItems": 20, "offset": 0, "workhead": "CR06", "grade": "L1" } ``` # 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 = { "maxItems": 20, "offset": 0, "workhead": "CR06", "grade": "L1" }; // Run the Actor and wait for it to finish const run = await client.actor("automation-lab/singapore-bca-registered-contractors-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 = { "maxItems": 20, "offset": 0, "workhead": "CR06", "grade": "L1", } # Run the Actor and wait for it to finish run = client.actor("automation-lab/singapore-bca-registered-contractors-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 '{ "maxItems": 20, "offset": 0, "workhead": "CR06", "grade": "L1" }' | apify call automation-lab/singapore-bca-registered-contractors-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=automation-lab/singapore-bca-registered-contractors-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Singapore BCA Registered Contractors Scraper", "description": "Export registered Singapore BCA contractors from data.gov.sg by workhead, grade, UEN, expiry, address, postal code, and phone.", "version": "0.1", "x-build-id": "8sb6jeSaZ8iVRDzdf" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/automation-lab~singapore-bca-registered-contractors-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-automation-lab-singapore-bca-registered-contractors-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/automation-lab~singapore-bca-registered-contractors-scraper/runs": { "post": { "operationId": "runs-sync-automation-lab-singapore-bca-registered-contractors-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/automation-lab~singapore-bca-registered-contractors-scraper/run-sync": { "post": { "operationId": "run-sync-automation-lab-singapore-bca-registered-contractors-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": { "maxItems": { "title": "Maximum records", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum contractor registration rows to save. Each row represents one company/workhead/grade registration.", "default": 20 }, "offset": { "title": "Start offset", "minimum": 0, "type": "integer", "description": "Dataset pagination offset. Use 0 for the first page or a higher number to resume a previous export.", "default": 0 }, "workhead": { "title": "Workhead", "type": "string", "description": "Exact BCA workhead code, for example CR06, CW01, ME01, or FM02." }, "grade": { "title": "Grade", "type": "string", "description": "Exact BCA registration grade, for example L1, L2, C1, or A1." }, "companyName": { "title": "Company name contains", "type": "string", "description": "Optional full-text search term for contractor company names." }, "uen": { "title": "UEN contains", "type": "string", "description": "Optional full-text search term for a Singapore UEN / company registration number." }, "expiryDate": { "title": "Expiry date", "type": "string", "description": "Optional exact BCA expiry date in DD/MM/YYYY format, for example 01/02/2028." } } }, "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 } } } } } } } } } } ```