HKEX Disclosure & Announcements Scraper

Scrape Hong Kong Exchange (HKEXnews) listed-company announcements and disclosures — the same data available on the official HKEXnews "Title Search" portal. Search by stock code or company name, filter by market board (Main Board / GEM), headline category, date range, and title keyword. Get stock code, company name, announcement title, category, document type, publish date, language, and a direct PDF/XLSX document link for every filing — from results announcements and circulars to disclosure-of-interest filings and ETF trading notices.

No login, no cookies, and no paid proxy required.

What this actor does

• Search the full HKEXnews disclosure archive by stock code, company name, market board, headline category, or free-text title keyword
• Narrow to one of 293 detailed document sub-types within a headline category (e.g. "Allotment Results" within "Announcements and Notices") — selecting a sub-category automatically fills in its parent headline category, so you don't need to set both
• Choose the market board — Main Board (SEHK) or GEM (Growth Enterprise Market)
• Filter by date range — HKEX allows up to a ~366-day window once a specific stock code is set, or a ~30-day rolling window otherwise (a headline category alone does not widen it)
• Sort by latest/oldest release time, or stock code/name
• Direct document links — every record includes a stable PDF (or XLSX/HTM) URL straight to the filed document
• Empty fields are omitted from the output

Output per announcement

• stockCode, stockCodes[] — primary and (for multi-stock filings) all affected stock codes
• companyName, companyNames[]
• title — the announcement headline
• category — HKEX headline category (e.g. "Announcements and Notices")
• documentType — the specific sub-type within the category, when the filing has one
• publishDate — release date/time in Hong Kong time (ISO 8601)
• language — English or Chinese, detected from the filing title
• documentUrl — direct link to the filed PDF/XLSX/HTM document
• fileType, fileSize
• documentOnDisplayUrl — link to view supporting documents on display, when provided
• newsId, sourceUrl
• recordType: "announcement", scrapedAt

Input

Field	Type	Default	Description
stockQuery	string	–	Stock code or company name; leave blank to search all securities
market	select	SEHK	SEHK (Main Board) / GEM (Growth Enterprise Market)
headlineCategory	select	All categories	One of HKEX's 19 headline categories
documentSubCategory	select	All sub-categories	One of HKEX's 293 detailed document sub-types within a headline category; auto-fills the matching headlineCategory if left as "All categories", and overrides a conflicting headlineCategory (with a warning) if one was also set
titleKeyword	string	–	Only return announcements whose title contains this word
dateFrom / dateTo	string	last 30 days	YYYY-MM-DD; window is auto-shortened to HKEX's own limit if too wide
sortBy	select	latest	latest / oldest / stockCodeAsc / stockCodeDesc / nameAsc / nameDesc
maxItems	int	100	Hard cap (1–3000)
proxyConfiguration	object	AUTO	Automatic datacenter-proxy fallback only

Example: Tencent's latest disclosures

{
  "stockQuery": "00700",
  "maxItems": 50
}

Example: all results announcements this year

{
  "headlineCategory": "10000",
  "titleKeyword": "results",
  "dateFrom": "2026-01-01",
  "dateTo": "2026-07-10",
  "maxItems": 200
}

Example: allotment results only (sub-category, no need to also set headlineCategory)

{
  "documentSubCategory": "15100",
  "maxItems": 100
}

Use cases

• Investor relations monitoring — track a specific issuer's full disclosure history by stock code
• Compliance and regulatory tracking — watch disclosure-of-interest filings and takeovers-code notices across the market
• Financial data platforms — build a searchable archive of HKEX filings, results, and circulars
• Equity research — screen results announcements and financial statements by headline category and date range
• News and market monitoring — surface newly filed announcements for HKEX-listed companies as they're published
• ETF and structured-product tracking — pull trading information filings for leveraged/inverse products and ETFs

FAQ

Does this require a HKEXnews account? No — HKEXnews publishes all listed-company disclosures publicly, with no login required.

Is this affiliated with HKEX? No — this is a third-party actor that reads HKEXnews' own public Title Search API. It is not affiliated with, endorsed by, or supported by Hong Kong Exchanges and Clearing Limited.

How far back does the data go? HKEXnews' headline-category search covers announcements from 25 June 2007 onward. Older filings may not be categorized and could be excluded from category-filtered searches.

Can I search by company name instead of stock code? Yes — stockQuery accepts either an exact stock code or part of the company name, resolved via HKEXnews' own securities lookup.

Why did my date range change? HKEXnews enforces its own search-window limit: about 30 days unless a specific stock code is set (a headline category alone doesn't widen it), and about 366 days once a stock code is set. If your requested range exceeds that, it's automatically shortened and a status message explains the adjustment.

Why do stockCodeDesc/nameDesc sometimes return records with no stockCode/companyName? Some HKEXnews filings (e.g. daily trading summaries for derivative warrants/CBBCs published by an issuer, not tied to one listed security) genuinely carry no stock code or company name. HKEXnews' own search API sorts these blank values ahead of real ones in descending order, so a narrow maxItems on stockCodeDesc/nameDesc can return mostly issuer-wide filings before reaching security-specific ones further down the list. stockCodeAsc/nameAsc are unaffected (blank values sort last, past typical result sizes). Widen maxItems if you need to reach the security-specific tail of a descending sort.

Why does the same filing sometimes appear twice with different stock codes? A small number of issuers list a dual-counter pair — the same company trading under two separate stock codes, most commonly a HKD-denominated counter and its RMB-denominated sibling (e.g. 03192 and 83192). HKEXnews' own search results list a document that covers both counters as two separate rows, one per stock code, sharing the same underlying document link. This actor mirrors that: each row is emitted as its own record (with its own stockCode/companyName), so a search for either counter's code correctly surfaces the filing.