# SGX Company Announcements Scraper (`crawlerbros/sgx-company-announcements-scraper`) Actor Scrape Singapore Exchange (SGX) listed-company announcements and disclosures. Search by issuer name or stock code, filter by category and date range. Get stock code, issuer name, announcement title, category, publish date, and direct document URL. - **URL**: https://apify.com/crawlerbros/sgx-company-announcements-scraper.md - **Developed by:** [Crawler Bros](https://apify.com/crawlerbros) (community) - **Categories:** Automation, News, Integrations - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 1,000 results 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/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 ## SGX Company Announcements Scraper Scrape Singapore Exchange (SGX) listed-company announcements and disclosures — the same data available on the official SGX "Company Announcements" portal. Search by issuer name or stock code, filter by category, subcategory, and date range. Get stock code, issuer name, announcement title, category, publish date, and a direct document link for every filing — from dividend and corporate-action announcements to annual reports, general announcements, and trading-status notices. No login, no API key, and no paid proxy required. ### What this actor does - **Search the full SGX disclosure archive** by issuer name, stock code, or free-text title keyword - **Filter by category and subcategory** — Announcements, Corporate Action, Product Announcements & Listings, or Trading Status, each with dozens of specific subcategories - **Filter by date range** - **Direct document links** — every record includes a stable URL straight to the filed document - Empty fields are omitted from the output ### Output per announcement - `stockCode`, `stockCodes[]` — primary and (for multi-security filings) all affected stock codes - `isinCode`, `isinCodes[]` - `issuerName`, `issuerNames[]` - `title` — the announcement headline - `category` — top-level SGX category (e.g. "Corporate Action") - `categoryCode`, `subcategoryCode` — machine-readable category codes - `publishDate` — submission date/time in Singapore time (ISO 8601) - `broadcastDate` — when the announcement was broadcast to the market (this is the field `dateFrom`/`dateTo` filter against, not `publishDate`); usually equal to `publishDate` except for replacement/amended filings - `submittedBy` - `documentUrl`, `sourceUrl` - `refId`, `announcementId` - `recordType: "announcement"`, `scrapedAt` ### Input | Field | Type | Default | Description | |---|---|---|---| | `issuerQuery` | string | – | Issuer name or stock code; leave blank to search all listed issuers | | `category` | select | All categories | One of SGX's 4 top-level categories | | `subcategory` | select | All subcategories | One of SGX's 76 specific subcategories | | `titleKeyword` | string | – | Only return announcements whose title contains this word | | `dateFrom` / `dateTo` | string | last 30 days | `YYYY-MM-DD`. Matches the announcement/broadcast date — for replacement/amended filings this can be later than the original `publishDate` | | `maxItems` | int | `100` | Hard cap (1–2000) | | `proxyConfiguration` | object | AUTO | Automatic datacenter-proxy fallback only | #### Example: DBS Group's latest disclosures (widen the date range — not every issuer files every month) ```json { "issuerQuery": "DBS", "dateFrom": "2025-07-01", "dateTo": "2026-07-10", "maxItems": 50 } ```` #### Example: all dividend announcements this year ```json { "subcategory": "CACT06", "dateFrom": "2026-01-01", "dateTo": "2026-07-10", "maxItems": 200 } ``` ### Use cases - **Investor relations monitoring** — track a specific issuer's full disclosure history by stock code - **Corporate action tracking** — monitor dividend, rights issue, and capital-reduction announcements across the market - **Financial data platforms** — build a searchable archive of SGX filings and corporate actions - **Compliance and regulatory tracking** — watch trading-status notices (halts, suspensions, queries) as they're filed - **Equity research** — screen annual reports and general announcements by category and date range - **News and market monitoring** — surface newly filed announcements for SGX-listed companies as they're published ### FAQ **Does this require an SGX account?** No — SGX publishes all listed-company disclosures publicly, with no login required. **Can I search by company name instead of stock code?** Yes — `issuerQuery` matches against both the issuer name and stock code. **What's the difference between category and subcategory?** Category is one of SGX's 4 top-level groupings (Announcements, Corporate Action, Product Announcements & Listings, Trading Status). Subcategory narrows to one specific announcement type within that grouping (e.g. "Cash Dividend/ Distribution" under Corporate Action). **Why does a record's `publishDate` fall outside my `dateFrom`/`dateTo` range?** `dateFrom`/`dateTo` filter by the announcement's broadcast date (`broadcastDate`), which is what SGX itself uses for its date-range search. For a first-time filing this is the same instant as `publishDate`. For a replacement or amended filing (title prefixed `REPL:`), SGX preserves the original submission timestamp in `publishDate` while `broadcastDate` reflects when the replacement was re-published — so the two can be weeks or months apart. **What's `submittedBy`?** The name of the person (usually a company secretary or authorized representative) who lodged the filing with SGX on the issuer's behalf. **Why do some records list multiple `stockCodes`/`isinCodes`?** A single announcement can apply to more than one listed security from the same issuer (e.g. an ordinary share and a preference share, or several bond tranches). Those filings carry every affected stock code and ISIN in `stockCodes[]`/`isinCodes[]`, alongside the primary `stockCode`/`isinCode`. **Is this affiliated with SGX?** No — this is a third-party actor that reads SGX's own public Company Announcements API. It is not affiliated with, endorsed by, or supported by Singapore Exchange. # Actor input Schema ## `issuerQuery` (type: `string`): Restrict results to one listed issuer. Enter part of the issuer/company name (e.g. `DBS`) or an exact stock code (e.g. `D05`). Leave blank to search across all listed issuers. Note: SGX doesn't file every issuer daily, so if you set this, also widen `dateFrom`/`dateTo` to make sure the issuer has a filing in range. ## `category` (type: `string`): Top-level SGX announcement category. Leave as "All categories" to search every category. ## `subcategory` (type: `string`): Narrow to one specific announcement subcategory. Leave as "All subcategories" to search every subcategory within the chosen category. ## `titleKeyword` (type: `string`): Only return announcements whose title contains this word (case-insensitive). ## `dateFrom` (type: `string`): Earliest announcement/broadcast date, `YYYY-MM-DD`. Defaults to 30 days before `dateTo`. Note: for replacement/amended filings (title starts with "REPL:"), this matches the record's `broadcastDate`, which can be later than its original `publishDate`. ## `dateTo` (type: `string`): Latest announcement/broadcast date, `YYYY-MM-DD`. Defaults to today. Note: for replacement/amended filings (title starts with "REPL:"), this matches the record's `broadcastDate`, which can be later than its original `publishDate`. ## `maxItems` (type: `integer`): Hard cap on emitted records. ## `proxyConfiguration` (type: `object`): Only used as an automatic fallback if SGX starts rate-limiting the datacenter IP. Leave the default AUTO group enabled — no paid proxy is required. ## Actor input object example ```json { "category": "", "subcategory": "", "maxItems": 100, "proxyConfiguration": { "useApifyProxy": true } } ``` # Actor output Schema ## `announcements` (type: `string`): Dataset containing all scraped SGX announcements. # 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 = { "issuerQuery": "", "category": "", "subcategory": "", "maxItems": 100, "proxyConfiguration": { "useApifyProxy": true } }; // Run the Actor and wait for it to finish const run = await client.actor("crawlerbros/sgx-company-announcements-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 = { "issuerQuery": "", "category": "", "subcategory": "", "maxItems": 100, "proxyConfiguration": { "useApifyProxy": True }, } # Run the Actor and wait for it to finish run = client.actor("crawlerbros/sgx-company-announcements-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 '{ "issuerQuery": "", "category": "", "subcategory": "", "maxItems": 100, "proxyConfiguration": { "useApifyProxy": true } }' | apify call crawlerbros/sgx-company-announcements-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=crawlerbros/sgx-company-announcements-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "SGX Company Announcements Scraper", "description": "Scrape Singapore Exchange (SGX) listed-company announcements and disclosures. Search by issuer name or stock code, filter by category and date range. Get stock code, issuer name, announcement title, category, publish date, and direct document URL.", "version": "1.0", "x-build-id": "SRIr27gJnpLJRrcfc" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~sgx-company-announcements-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-sgx-company-announcements-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/crawlerbros~sgx-company-announcements-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-sgx-company-announcements-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/crawlerbros~sgx-company-announcements-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-sgx-company-announcements-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": { "issuerQuery": { "title": "Issuer name or stock code", "type": "string", "description": "Restrict results to one listed issuer. Enter part of the issuer/company name (e.g. `DBS`) or an exact stock code (e.g. `D05`). Leave blank to search across all listed issuers. Note: SGX doesn't file every issuer daily, so if you set this, also widen `dateFrom`/`dateTo` to make sure the issuer has a filing in range." }, "category": { "title": "Category", "enum": [ "", "ANNC", "CACT", "PLST", "TRAD" ], "type": "string", "description": "Top-level SGX announcement category. Leave as \"All categories\" to search every category.", "default": "" }, "subcategory": { "title": "Subcategory", "enum": [ "", "ANNC01", "ANNC02", "ANNC03", "ANNC04", "ANNC05", "ANNC30", "ANNC06", "ANNC07", "ANNC31", "CACT22", "CACT01", "TRAD08", "CACT02", "CACT03", "CACT04", "CACT06", "ANNC08", "ANNC09", "ANNC10", "ANNC29", "ANNC11", "PLST01", "CACT24", "CACT07", "CACT25", "ANNC12", "TRAD09", "TRAD01", "ANNC14", "CACT09", "CACT08", "ANNC15", "CACT05", "ANNC16", "CACT10", "ANNC17", "ANNC18", "ANNC19", "CACT23", "CACT11", "PLST03", "PLST05", "PLST06", "PLST07", "PLST08", "CACT12", "ANNC20", "ANNC21", "ANNC22", "CACT13", "PLST09", "CACT14", "CACT15", "ANNC23", "TRAD02", "ANNC24", "CACT16", "TRAD03", "TRAD04", "TRAD05", "TRAD06", "ANNC25", "CACT18", "CACT19", "ANNC13", "CACT17", "ANNC26", "CACT20", "CACT21", "ANNC27", "TRAD10", "TRAD11", "TRAD12", "TRAD13", "ANNC28", "PLST10" ], "type": "string", "description": "Narrow to one specific announcement subcategory. Leave as \"All subcategories\" to search every subcategory within the chosen category.", "default": "" }, "titleKeyword": { "title": "Title contains keyword", "type": "string", "description": "Only return announcements whose title contains this word (case-insensitive)." }, "dateFrom": { "title": "Date from", "type": "string", "description": "Earliest announcement/broadcast date, `YYYY-MM-DD`. Defaults to 30 days before `dateTo`. Note: for replacement/amended filings (title starts with \"REPL:\"), this matches the record's `broadcastDate`, which can be later than its original `publishDate`." }, "dateTo": { "title": "Date to", "type": "string", "description": "Latest announcement/broadcast date, `YYYY-MM-DD`. Defaults to today. Note: for replacement/amended filings (title starts with \"REPL:\"), this matches the record's `broadcastDate`, which can be later than its original `publishDate`." }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Hard cap on emitted records.", "default": 100 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Only used as an automatic fallback if SGX starts rate-limiting the datacenter IP. Leave the default AUTO group enabled — no paid proxy is required.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } } ```