HKEX Listed Company Announcements & Filings Scraper

Here is one real result, with every field the actor returns (the long documentText is trimmed to an opening excerpt; the real value continues):

{
  "stockCode": "08290",
  "companyName": "AHSAY BACKUP",
  "title": "Interim Report 2026",
  "category": "Financial Statements/ESG Information",
  "documentType": "Interim/Half-Year Report",
  "dateTime": "14/08/2026 12:11",
  "publishedAt": "2026-08-14T12:11:00+08:00",
  "fileType": "PDF",
  "fileSize": "1MB",
  "documentUrl": "https://www1.hkexnews.hk/listedco/listconews/gem/2026/0814/2026081400213.pdf",
  "newsId": "12284015",
  "source": "HKEXnews",
  "observedAt": "2026-08-14T08:16:10.613Z",
  "documentText": "( Incorporated in the Cayman Islands with limited liability ) Stock Code : 8290 Interim Report 2025 Ahsay Backup Software Development Company Limited ... During the six months ended 30 June 2026 and 2025, the Group recorded revenues of approximately HK$16.7 million and HK$18.9 million respectively, representing a decrease of approximately 11.6%. [trimmed]",
  "aiSummary": "Ahsay Backup Software Development Company Limited has released its Interim Report for the six months ended June 30, 2026, showing a revenue decline to approximately HK$16.7 million, down 11.6% from HK$18.9 million in the same period last year. The company reported a reduced loss of HK$0.1 million compared to a loss of HK$0.2 million in 2025, attributed to lower content acquisition and staff costs. This report highlights the challenges faced by the company due to a sluggish global economy and increased competition in the online backup software market.",
  "aiExtract": {
    "eventType": "Interim Results",
    "isPriceSensitive": true,
    "amounts": ["HK$16.7 million", "HK$18.9 million", "HK$0.1 million", "HK$0.2 million"],
    "parties": ["Ahsay Backup Software Development Company Limited"],
    "keyDates": ["30 June 2026", "30 June 2025"]
  }
}

The most complete HKEX filings scraper available. It returns every field HKEXnews exposes for each announcement (company, stock code, category, document type, publish time and official document URL), plus optional full document text and AI summary and structured extraction, and gives you six filters to target exactly the filings you need.

📥 Input · 📤 Output · 💰 Pricing · ▶️ Examples

Table of contents

• What it does
• Quickstart
• Input reference
• Output reference
• Example output record
• Run via API and CLI
• Fetch results
• Billing and limits
• FAQ and troubleshooting

What it does

The actor queries HKEXnews (the official Hong Kong Stock Exchange disclosure portal), applies the filters you pass as input (title keyword, stock code, market, date range), and writes one normalized record per announcement to the run's dataset. Each record includes the company, stock code, filing category and document type, the publish time and the official document URL. Optional paid add-ons download the filing (PDF or HTML) and add its extracted plain-text body, an AI plain-English summary, and AI structured extraction of event type, price-sensitivity, amounts, parties and key dates.

Data covers listed-company announcements on HKEXnews for the Main Board (SEHK) and GEM. It is independent and has no affiliation with Hong Kong Exchanges and Clearing.

Quickstart

Open the actor, paste this into the input, and press Run. It returns two interim-report filings with document text and both AI add-ons on.

{
  "searchText": "interim report",
  "maxAnnouncements": 2,
  "market": "SEHK",
  "withFullText": true,
  "withSummary": true,
  "withExtract": true
}

Leave searchText empty to pull the most recent announcements with no title filter. Every input field is optional; with an empty input the actor returns recent SEHK announcements (default maxAnnouncements is 10).

Input reference

Field	Type	Required	Default	Description
maxAnnouncements	integer	no	10	Maximum announcements to collect. Free Apify plans are capped at 10 per run.
searchText	string	no	interim report	Only return announcements whose title contains this text (for example connected transaction, profit warning, dividend).
stockCode	string	no	(empty)	Only return filings from one listed company, by HKEX stock code (for example 00700 or 700).
market	enum	no	SEHK	Which market to search: SEHK (Main Board and all SEHK) or GEM.
fromDate	string	no	(empty)	Earliest publication date, format YYYYMMDD (for example 20260101).
toDate	string	no	(empty)	Latest publication date, format YYYYMMDD (for example 20261231).
withFullText	boolean	no	false	Paid add-on. Download each filing and add its extracted plain-text body. Charged per document successfully fetched. Paid plans only.
withSummary	boolean	no	false	Paid AI add-on. Write a plain-English summary of each filing. Requires downloading the document. Charged per filing summarized. Paid plans only.
withExtract	boolean	no	false	Paid AI add-on. Extract structured facts (event type, price-sensitivity, amounts, parties, key dates). Requires downloading the document. Charged per filing processed. Paid plans only.

Output reference

One dataset item per announcement. Types: string, boolean, object, string[], or null when the source value is absent.

Field	Type	Description
stockCode	string	HKEX stock code of the filing company.
companyName	string	Listed company name.
title	string	Announcement title.
category	string	HKEX headline category (for example Financial Statements/ESG Information).
documentType	string	Document type (for example Interim/Half-Year Report).
dateTime	string	Publication date and time as displayed (DD/MM/YYYY HH:mm).
publishedAt	string	ISO 8601 publication timestamp (Hong Kong time).
fileType	string	Document file type (for example PDF).
fileSize	string	Document file size as displayed (for example 1MB).
documentUrl	string	URL of the official filing document.
newsId	string	HKEXnews news ID.
source	string	Data source. Always HKEXnews.
observedAt	string	ISO 8601 timestamp of when the record was collected.
documentText	string	Extracted plain-text body of the filing (add-on), or absent when withFullText is off.
aiSummary	string	AI plain-English filing summary (add-on), or absent.
aiExtract	object	AI structured facts (add-on): eventType, isPriceSensitive, amounts, parties, keyDates, or absent.

Example output record

Real record from a live run (input {"searchText":"interim report","maxAnnouncements":2,"market":"SEHK","withFullText":true,"withSummary":true,"withExtract":true}). The long documentText is trimmed to an opening excerpt; the real value continues:

{
  "stockCode": "08290",
  "companyName": "AHSAY BACKUP",
  "title": "Interim Report 2026",
  "category": "Financial Statements/ESG Information",
  "documentType": "Interim/Half-Year Report",
  "dateTime": "14/08/2026 12:11",
  "publishedAt": "2026-08-14T12:11:00+08:00",
  "fileType": "PDF",
  "fileSize": "1MB",
  "documentUrl": "https://www1.hkexnews.hk/listedco/listconews/gem/2026/0814/2026081400213.pdf",
  "newsId": "12284015",
  "source": "HKEXnews",
  "observedAt": "2026-08-14T08:16:10.613Z",
  "documentText": "( Incorporated in the Cayman Islands with limited liability ) Stock Code : 8290 Interim Report 2025 Ahsay Backup Software Development Company Limited ... During the six months ended 30 June 2026 and 2025, the Group recorded revenues of approximately HK$16.7 million and HK$18.9 million respectively, representing a decrease of approximately 11.6%. [trimmed]",
  "aiSummary": "Ahsay Backup Software Development Company Limited has released its Interim Report for the six months ended June 30, 2026, showing a revenue decline to approximately HK$16.7 million, down 11.6% from HK$18.9 million in the same period last year. The company reported a reduced loss of HK$0.1 million compared to a loss of HK$0.2 million in 2025, attributed to lower content acquisition and staff costs.",
  "aiExtract": {
    "eventType": "Interim Results",
    "isPriceSensitive": true,
    "amounts": ["HK$16.7 million", "HK$18.9 million", "HK$0.1 million", "HK$0.2 million"],
    "parties": ["Ahsay Backup Software Development Company Limited"],
    "keyDates": ["30 June 2026", "30 June 2025"]
  }
}

Run via API and CLI

Start a run and wait for it to finish, then read the dataset. Replace <TOKEN> with your Apify API token.

Run synchronously and get dataset items in one call:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~hkex-announcements-scraper/run-sync-get-dataset-items?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"stockCode":"00700","maxAnnouncements":25}'

Start a run asynchronously:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~hkex-announcements-scraper/runs?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"searchText":"profit warning","fromDate":"20260101","toDate":"20261231","maxAnnouncements":100}'

Apify CLI:

apify call scrapers_lat/hkex-announcements-scraper \
  --input '{"searchText":"dividend","market":"GEM"}'

Fetch results

Every run writes to a dataset. Fetch items as JSON, CSV, or Excel by changing format:

# JSON
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=json"

# CSV
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=csv"

# Paginate large datasets
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&offset=1000&limit=1000"

<DATASET_ID> is returned as defaultDatasetId in the run object. Use offset and limit to page through large result sets. clean=true drops empty and internal fields.

Billing and limits

• Pay per result. You are charged per announcement record returned (result event). See the pricing tab for the current per-result price.
• Add-on events. Document full text (full_text), AI summary (ai_summary) and AI structured extraction (ai_extract) are billed separately, and only when they produce usable output.
• No charge on failure. If a run errors, the actor writes a single item with a populated error field and does not charge for it. Empty runs cost nothing.
• Spend cap respected. Set maxTotalChargeUsd on the run; once reached, the actor stops emitting and charging further billable results.
• Free Apify plans are capped at 10 records per run. Upgrade for higher maxAnnouncements.

FAQ and troubleshooting

A run returned 0 records. Why? The filter combination matched nothing. Loosen filters (for example remove searchText or widen the date range), or confirm the stockCode. Zero-result runs are not charged.

How do I follow one company? Set stockCode to its HKEX code (for example 00700). Leading zeros are optional. Add a searchText to keep only certain filing types.

Do I get the actual filing document? The record always includes the official documentUrl. Enable withFullText to also download the PDF or HTML and add its extracted documentText.

What is price-sensitivity in the AI extraction? aiExtract.isPriceSensitive flags filings the AI judges likely to move the share price (for example results, acquisitions, profit warnings). It is a machine summary, not a regulatory classification.

What is the difference between SEHK and GEM? SEHK covers the Main Board and all SEHK filings; GEM covers the Growth Enterprise Market for smaller companies. Choose with the market field.

Is this an official HKEX tool? No. This actor is independent and has no affiliation with Hong Kong Exchanges and Clearing. It reads only publicly available HKEXnews disclosures. Use the results in accordance with the source's terms and applicable laws.

Related scrapers

• Hong Kong SFC Licensees Scraper: SFC-licensed firms and representatives in Hong Kong.
• SEC EDGAR Company Filings Scraper: US SEC filings by ticker or CIK.
• Korea DART Filings Scraper: Korean listed-company disclosures.

More scrapers at scrapers.lat

Built and maintained by scrapers.lat, where we publish scrapers for US and Latin American public platforms: company registries, government data, finance, e-commerce and more. Browse the catalog or request a custom scraper at scrapers.lat.

---

Independent tool, not affiliated with Hong Kong Exchanges and Clearing. Accesses only publicly available HKEXnews disclosures. Use in accordance with the source's terms and applicable laws.