HKEX Scraper | Announcements and Filings avatar

HKEX Scraper | Announcements and Filings

Pricing

from $1.70 / 1,000 announcements

Go to Apify Store
HKEX Scraper | Announcements and Filings

HKEX Scraper | Announcements and Filings

HKEX scraper for HKEXnews (披露易, 港交所) announcements and filings of Hong Kong listed companies: 60 announcements from 3 stock codes in 6 seconds, 19 fields each. Get category codes, stock codes, publication time, document link, file size and full text. Filter by date, category, keyword and language.

Pricing

from $1.70 / 1,000 announcements

Rating

0.0

(0)

Developer

SilentFlow

SilentFlow

Maintained by Community

Actor stats

0

Bookmarked

2

Total users

1

Monthly active users

3 days ago

Last modified

Categories

Features

Limited permissions

Share

HKEX Scraper (披露易) | Announcements, Filings and Document Text (2026)

HKEX announcements, 19 fields each, from any code.

From SilentFlow. Creators of Facebook Search Scraper and JD Products Scraper (#1 for “jd” in Apify Store search), with 1,000,000+ combined lifetime runs.

Turn HKEXnews, the official disclosure portal of the Hong Kong stock exchange (港交所), into a clean feed of announcements: one row per filing, with the issuer, the HKEX category and subcategory codes, the publication time in Hong Kong, the document link and, on request, the full document text. Our default test run read the latest 20 filings of Tencent, HSBC and Alibaba, 60 announcements, in 5 seconds.

Why choose this actor?

Opening HKEXnews every morning and searching your portfolio one stock code at a time? Stuck with a whole-market search that stops at one month and 100 rows per page? Downloading PDFs one by one to find out what a filing actually says?

  • Your whole watchlist in one run, each code with its own cap. Paste a list of stock codes and get every code's announcements, newest first. In our test, 20 Hang Seng heavyweights over 3 months returned 441 announcements in 30 seconds, with Tencent, HSBC and ICBC each stopping at their own cap of 50 instead of crowding out the smaller filers.
  • The full archive and the whole market, not the first page. A stock code reads back to the start of the archive: 1,813 announcements for Tencent since its listing in June 2004, 6,732 for HSBC. Without a code, the run reads the Main Board and GEM together over any period you set, and cuts long periods into the windows the site accepts: the 200 latest Next Day Disclosure Returns of the whole market, 188 of them share buybacks, came back in 5 seconds.
  • Rows ready for code, compliance tools and AI. Every row carries HKEX's category and subcategory codes (10000 and 13600 for quarterly results), the board, every stock code of the filing (HKD and RMB counters), the revision status the exchange puts on reissued or cancelled filings, and, when you switch it on, the document text: 30 profit warnings of the past month came back with their full text in under 20 seconds, no account needed.

Try HKEX Scraper free

Try your first 60 announcements

Paste this input in the JSON tab of the Input page and press Start. It reads the 20 latest announcements of Tencent (00700), HSBC (00005) and Alibaba (09988).

{
"stockCodes": ["00700", "00005", "09988"],
"maxItems": 20
}

It runs on the Apify Free plan. Each announcement becomes one row of your dataset. Open the Output tab to see the "Announcements" table (title, stock code, stock name, category, subcategory, publication time and document link), or switch to "Documents" for the announcement ID, board, category codes, file type, size and language. Export the rows as JSON, CSV or Excel, or pull them from the API into your own tools.

How it works

Copy to your AI assistant

Paste this block into Claude, ChatGPT or Cursor to give it full context about this scraper:

You have access to the HKEX Scraper on Apify: silentflow/hkex-scraper
It returns announcements published on HKEXnews (www1.hkexnews.hk), the disclosure portal of
Hong Kong Exchanges and Clearing, one row per announcement and language.
Input (no field is required; an empty input reads the latest announcements of the whole market):
- stockCodes (array of strings): HKEX stock codes, "00700", "700", "0700.HK", "HKEX:700" or a
hkex.com.hk quote page link. Main Board, GEM and delisted codes. Each code returns its
announcements newest first, up to maxItems per code.
- announcementUrls (array of strings): HKEXnews document links
(https://www1.hkexnews.hk/listedco/listconews/...). One row per link, whatever maxItems says.
- dateFrom, dateTo (string): "2026-11-01" or a delay back from today such as "7 days", "1 month".
Defaults: whole archive (back to 1999) for stock codes, yesterday to today for the whole market.
- categories (array of headline category codes): 10000 Announcements and Notices, 20000 Circulars,
30000 Listing Documents, 40000 Financial Statements/ESG Information, 50000 Next Day Disclosure
Returns, 51500 Monthly Returns, 52000 Proxy Forms, 53000 Company Information Sheet,
54000 Constitutional Documents, 55000 Takeovers Code dealing disclosures, 56000 Documents on
Display, 70000 Debt and Structured Products, 80000 ETF trading information, 81000 Leveraged and
Inverse Products, 90000 Regulatory Announcement & News, 91000 Application Proofs and PHIPs
- keyword (string): words the title must contain, e.g. "profit warning"
- language (string: en | zh, default en): English or Traditional Chinese
- maxItems (integer, default 100): per stock code, or in total for the whole market
- includeContent (boolean, default false): add the text of PDF and HTML documents
- debugMode (boolean, default false)
Output per row (20 fields, plus attachments and content when present):
- id (string, HKEXnews announcement ID), url (document link), title
- category, categoryCode, subCategory, subCategoryCode (several subcategories joined by " / "
and their codes by ","), status (revision note such as "Cancelled and Reissued", or null),
isCancelled (boolean)
- stockCode, stockName (first security of the filing), stocks [{code, name}] (all of them),
market (SEHK for the Main Board, GEM)
- fileType (pdf, htm, xlsx), fileSize ("731KB"), fileSizeKb (number), isMultiFile (boolean),
attachments [{title, url}] for multi-document filings
- publishedAt (RFC 3339, Hong Kong time, +08:00), content (document text, when asked),
language (en | zh), scrapedAt (RFC 3339, UTC)
Use apify-client for Python or JavaScript.

How to scrape HKEX announcements

Get the latest announcements of one company

The simplest run: one stock code, the 20 most recent filings, newest first.

{
"stockCodes": ["700"],
"maxItems": 20
}

The code can be typed the way you have it: 700, 00700, 0700.HK or a quote page link from hkex.com.hk all read Tencent.

Pull every profit warning of the past month

No stock code: the run reads the Main Board and GEM together and keeps the titles that contain your words.

{
"keyword": "profit warning",
"dateFrom": "1 month",
"maxItems": 200
}

Swap the keyword for buy-back, connected transaction, change of auditor or resumption of trading to build any event list.

Follow results and circulars of a watchlist in Chinese

Combine codes, categories, a period and the language. Titles, stock names, categories and document links all switch to Traditional Chinese.

{
"stockCodes": ["00700", "09988", "03690", "01810", "01211"],
"categories": ["10000", "40000"],
"dateFrom": "3 months",
"language": "zh",
"maxItems": 30
}

Our Chinese test run on these five codes, without the category filter, returned 116 announcements in 13 seconds.

Input parameters

ParameterTypeDefaultWhat it does
stockCodesarray of stringsnoneHKEX stock codes to follow. Each code returns its announcements newest first, up to maxItems per code.
announcementUrlsarray of stringsnoneHKEXnews document links. Each link returns its announcement, whatever maxItems says.
dateFromstringarchive start (codes), yesterday (market)First publication day, Hong Kong time. A date or a delay back from today.
dateTostringtodayLast publication day, Hong Kong time.
categoriesarray of codesallHKEXnews headline categories to keep.
keywordstringnoneWords the title must contain.
languageen or zhenEnglish or Traditional Chinese rows.
maxItemsinteger100Most announcements per stock code, or in total for the whole market.
includeContentbooleanfalseAdds the text of PDF and HTML documents in content.
debugModebooleanfalseDetailed logs.

With no stock code and no link, the run reads the whole market: Main Board and GEM, merged and sorted by publication time.

Accepted stock code formats

  • 00700, 700, 5: plain numbers are padded to the 5-digit HKEX code.
  • 0700.HK, 700.HK, 700 HK: market data style tickers.
  • HKEX:700, SEHK:1810, HK:9988: exchange prefixes.
  • https://www.hkex.com.hk/Market-Data/Securities-Prices/Equities/Equities-Quote?sym=700: a quote page link.
  • GEM codes (08490) and delisted codes (00007) work the same way. A delisted code reads the archive of the company that last held it.

Anything else (a company name, a 6-digit number) is skipped with a note in the log, and the rest of the list still runs.

  • Document links: https://www1.hkexnews.hk/listedco/listconews/sehk/2026/1118/2026111800448.pdf, for the Main Board (/sehk/) or GEM (/gem/), in PDF, HTML or spreadsheet form.
  • Chinese document links, whose file name ends in _c, return the Chinese row.
  • A link to one file of a multi-document announcement (.../2026/1118/12417935/2026111801557.pdf) returns the announcement it belongs to, with its full file list.
  • A document link pasted in stockCodes, or a quote page link pasted in announcementUrls, is read for what it is.

Accepted dates

  • A day: 2026-11-01, 2026/11/01, 20261101 or 01/11/2026 (day first, as on HKEXnews).
  • A delay back from today: 7 days, 2 weeks, 1 month, 1 year, today, yesterday. Delays keep a scheduled run looking at the same window every time.
  • Days are Hong Kong calendar days. A dateTo in the future reads up to today.

What data can you extract from HKEXnews?

Every row is one announcement in one language, with 20 fields, plus attachments on multi-document filings and content when you ask for the text.

FieldTypeDescription
idstringHKEXnews announcement ID, stable across runs.
urlstringLink to the document on HKEXnews.
titlestringAnnouncement title, decoded and on one line.
categorystringHeadline category (tier one), such as Announcements and Notices.
categoryCodestringHKEX code of the category, such as 10000.
subCategorystring or nullSubcategories (tier two), joined by / when there are several.
subCategoryCodestring or nullTheir HKEX codes, joined by commas.
statusstring or nullThe exchange's revision note: Cancelled and Reissued, Headlines Revised, Cancelled [Incorrect Submission], Cancelled since Headlines Superseded and Replaced.
isCancelledbooleanTrue when the filing was cancelled.
stockCodestringFirst stock code of the filing.
stockNamestringIts short name.
stocksarrayEvery security of the filing, {code, name}: HKD and RMB counters, or a family of ETFs.
marketstringSEHK (Main Board) or GEM.
fileTypestring or nullpdf, htm or xlsx; null for a multi-document announcement.
fileSizestring or nullSize as HKEXnews shows it, such as 731KB.
fileSizeKbnumber or nullThe same size in kilobytes.
isMultiFilebooleanTrue when the announcement holds several documents.
attachmentsarrayFor multi-document announcements: every file, {title, url}.
publishedAtstringPublication time, RFC 3339 with the Hong Kong offset (+08:00).
contentstringDocument text, when includeContent is on.
languagestringen or zh.
scrapedAtstringWhen the row was read, RFC 3339 in UTC.

In our default run, all 20 fields were filled on all 60 rows, except the subcategory, which HKEX gives to 54 of them: monthly returns and some debt notices have none. status is null on a normal filing; in one month of Main Board filings (19 October to 18 November 2026), 56 of 10,000 carried a revision status.

Output example

{
"id": "12416823",
"url": "https://www1.hkexnews.hk/listedco/listconews/sehk/2026/1118/2026111800448.pdf",
"title": "ANNOUNCEMENT OF THE RESULTS FOR THE THREE AND NINE MONTHS ENDED 30 SEPTEMBER 2026",
"category": "Announcements and Notices",
"categoryCode": "10000",
"subCategory": "Quarterly Results",
"subCategoryCode": "13600",
"status": null,
"isCancelled": false,
"stockCode": "00700",
"stockName": "TENCENT",
"stocks": [
{ "code": "00700", "name": "TENCENT" },
{ "code": "80700", "name": "TENCENT-R" }
],
"market": "SEHK",
"fileType": "pdf",
"fileSize": "731KB",
"fileSizeKb": 731,
"isMultiFile": false,
"publishedAt": "2026-11-18T16:30:00+08:00",
"language": "en",
"scrapedAt": "2026-11-19T04:00:12Z"
}

A multi-document announcement, such as the Documents on Display filing of 18 November 2026 for stock code 01783, comes with "isMultiFile": true and an attachments list: 7 files in our test, from the memorandum and articles of association to three annual reports, each with its title and link.

Advanced usage

Check your portfolio every morning

Schedule this input daily. With a delay instead of a date, each run reads the filings of the last day for every code on your list.

{
"stockCodes": ["00700", "00005", "09988", "00939", "01299", "00941", "03690", "01810", "00388", "02318"],
"dateFrom": "1 day",
"maxItems": 50
}

Add a webhook on the run to post new rows to Slack or Teams, or to your compliance case tool.

Track share buybacks across the market

Next Day Disclosure Returns carry the share buybacks of every issuer. This input reads a week of them for the whole market.

{
"categories": ["50000"],
"dateFrom": "7 days",
"maxItems": 1000
}

In our test, 188 of the 200 latest returns had the Share Buyback subcategory (code 50100): filter on subCategoryCode to keep only them.

Feed announcement text to an AI assistant or a search index

Switch on the document text and every PDF or HTML filing comes with its text in content.

{
"keyword": "profit warning",
"dateFrom": "1 month",
"includeContent": true,
"maxItems": 30
}

Our runs returned 30 of 30 profit warnings with their text, 2,900 to 6,000 characters each, in under 20 seconds. Chinese documents keep their characters joined, so they index cleanly.

Collect a year of annual reports and ESG reports

A category lets the whole-market search cover up to a year per window, and the run chains the windows for longer periods.

{
"categories": ["40000"],
"dateFrom": "2026-01-01",
"maxItems": 2000
}

Each row gives the file size in kilobytes, handy to plan the download of large reports.

Rebuild the full filing history of a company

Leave the dates empty and raise the cap: a stock code reads back to the first filing in the archive.

{
"stockCodes": ["00700"],
"maxItems": 2000
}

Tencent's history starts with its prospectus of 7 June 2004, and that document link still opens today. Delisted companies work the same way: their code reads the archive of their last listing.

FAQ

What is HKEXnews? HKEXnews (披露易) is the disclosure portal of Hong Kong Exchanges and Clearing (HKEX, 港交所), the operator of the Hong Kong stock exchange. Every company listed on the Main Board or on GEM must publish its announcements there: results, profit warnings, director changes, share buybacks, circulars, monthly returns, listing documents. It plays the role that EDGAR plays for US listed companies.

Do I need an HKEX account, a licence or an API key? No. The actor reads the public HKEXnews portal. No login and no key: add stock codes, or nothing at all, and press Start.

How fresh is the data? Each run reads HKEXnews live, at the time of the run. A filing appears as soon as the exchange publishes it: our run of 19 November 2026 at noon, Hong Kong time, already returned the share buyback returns published at 12:00. On 18 November 2026 alone, 645 filings were published on the Main Board.

How far back can I go? For a stock code, to the start of the archive: Tencent's 1,813 announcements go back to its listing in June 2004, and HSBC has 6,732. For the whole market, any period: the site answers one month at a time (one year with a category), and the actor chains the windows for you.

Can I follow several companies in one run? Yes, that is what the stock code list is for. Each code gets its own cap, so a busy filer never hides a quiet one. Our run of 20 large caps over 3 months returned 441 announcements in 30 seconds. An announcement filed under two codes of your list (00700 and 80700) comes once.

Which languages are available? English (en) and Traditional Chinese (zh). The language changes the title, the stock names, the categories and the document link. A few issuers publish some documents in one language only, so a filing can be missing from one of the two.

What does the status field mean? HKEX marks filings it replaced or withdrew: Cancelled and Reissued, Headlines Revised, Cancelled [Incorrect Submission], Cancelled since Headlines Superseded and Replaced. The label is the same in both languages, and isCancelled lets you drop withdrawn filings in one filter. When a cancelled filing shares its document with its replacement, the run keeps the newer row.

How does the document text work? With includeContent on, the actor downloads each PDF or HTML document and adds its text in content, up to 500,000 characters, enough for a full annual report's statements and notes. Spreadsheets (ETF trading information) keep their link only, and multi-document announcements list their files in attachments. A document that cannot be read keeps its row, without content. Runs with the text take longer, since every document is downloaded.

Are the document links permanent? Yes. Links point to the HKEXnews archive, organised by publication date: the oldest Tencent document, published on 7 June 2004, still opens. The id is the exchange's announcement number and stays the same across runs, so you can deduplicate scheduled runs on it.

Why do some rows have no subcategory? HKEX gives a subcategory to most filings but not all: monthly returns, ETF trading information and some debt notices only have a headline category. In our default run, 54 of 60 rows had one.

Can I combine filters? Yes, they all apply together. stockCodes + categories + dateFrom + keyword returns, for example, only the circulars of your watchlist that mention a connected transaction in the last quarter. Several categories are read side by side and merged by publication time.

What is the difference between SEHK and GEM? SEHK is the Main Board of the Stock Exchange of Hong Kong; GEM is the board for smaller growth companies, whose stock codes run from 08001 to 08999. The whole-market search reads both and the market field says which board each filing belongs to.

More SilentFlow scrapers

🛒 E-commerce

💼 Jobs

🏠 Real estate

📣 Social media

🏢 Business data

✈️ Travel

🎯 Lead generation

🔎 SEO

🎬 Video

📰 News

🧰 More tools

Support

Need something this scraper doesn't do yet? We ship features fast.

  • Feature requests go straight to our backlog
  • Enterprise needs? We do custom integrations and high-volume plans
  • Pricing questions? Check the Monetization tab on the actor page

Response time: usually under 24 hours.

This Actor extracts publicly available data from HKEXnews (hkexnews.hk), the disclosure portal of Hong Kong Exchanges and Clearing. It does not bypass any login, paywall or CAPTCHA. Users are responsible for complying with HKEX's terms of use, including its rules on the reuse and redistribution of the information, and with applicable data protection laws (GDPR, CCPA, and PIPL where relevant). Announcements are published by listed companies and may name directors and officers; handle such personal data accordingly. The data returned is informational and is not investment advice; check the original filing before any regulated use.

Built for compliance teams, event-driven funds, research desks and fintech builders who need Hong Kong filings as data, not as PDFs to open one by one.