{ "openapi": "3.0.1", "info": { "title": "Singapore BCA Registered Contractors Scraper (CRS Directory)", "description": "Scrape the Singapore BCA CRS registered contractors directory with no API key. Get company name, UEN, address, postal code, phone, fax, workhead, grade, tendering limit, registration expiry and the full registration profile. Build construction leads and KYB data. Export to JSON, CSV or Excel.", "version": "0.1", "x-build-id": "WfeDi7CJbdTMdNwbC" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapers_lat~singapore-bca-contractors-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapers_lat-singapore-bca-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/scrapers_lat~singapore-bca-contractors-scraper/runs": { "post": { "operationId": "runs-sync-scrapers_lat-singapore-bca-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/scrapers_lat~singapore-bca-contractors-scraper/run-sync": { "post": { "operationId": "run-sync-scrapers_lat-singapore-bca-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": { "maxContractors": { "title": "Max Contractors", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Maximum number of contractor records to collect. Leave high to pull everything for the selected workheads and grades." }, "workheads": { "title": "Workhead codes", "type": "array", "description": "Workhead codes to collect, for example \"CW01\" (General Building), \"CW02\" (Civil Engineering), \"ME05\" (Electrical Engineering). Leave empty to scrape every registered-contractor workhead (CW, CR, ME, RW, TR).", "items": { "type": "string" } }, "grades": { "title": "Grades", "type": "array", "description": "Grades to keep, for example \"A1\", \"A2\", \"B1\", \"B2\", \"C1\", \"C2\", \"C3\" for construction workheads, or \"L1\"..\"L6\" for construction-related and M&E workheads. Leave empty to include every grade available for each selected workhead.", "items": { "type": "string" } }, "withDetails": { "title": "Fetch full registration profile (paid add-on)", "type": "boolean", "description": "Open each company page to add the registration expiry date and active/expired status for the workhead, the company's complete registration profile (every workhead, grade, tendering limit and expiry it holds) and any Licensed Builder licences. Slower, and billed as a details add-on per enriched record. Company name, UEN, address, postal code, phone, fax, workhead, grade and tendering limit are always collected without this.", "default": false }, "nameQuery": { "title": "Company name contains", "type": "string", "description": "Optional. Only return contractors whose company name contains this text (case-insensitive), for example \"engineering\" or a specific firm name." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional. Standard Apify proxy configuration. The directory is reachable directly, so leave this off for most runs; enable Apify Residential proxy (country SG) only if results come back empty." } } }, "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 } } } } } } } } } }