Search HKEx Filings
search_filingsRead-onlyIdempotent
Search live HKEx filings in a date window (at most 31 days).
``from_date``/``to_date`` accept YYYY-MM-DD or DD/MM/YYYY. All filters are optional and
combine with AND semantics: ``stock_code`` matches exactly (e.g. ``01461`` or ``1461``);
``title_query``, ``category`` and ``stock_name`` are case-insensitive substrings (e.g.
category ``Dividend``); ``document_type`` matches the file type exactly (e.g. ``PDF`` or
``HTML``). Filters are applied to the fetched window, so widen ``max_results`` to catch
rarer matches. ``max_results`` caps the number of filings fetched and returned (hard cap
200). Returns the matching filings — each carrying ``fileType``, ``sizeText``,
``category`` and ``newsId`` metadata — plus the HKEx-reported total for the window. Use
list_filing_facets first to see which categories, types and codes exist in a window.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to_date | Yes | YYYY-MM-DD or DD/MM/YYYY | |
| category | No | Optional case-insensitive substring of the headline category | |
| from_date | Yes | YYYY-MM-DD or DD/MM/YYYY | |
| stock_code | No | Optional exact HKEx stock code, e.g. 01461 | |
| stock_name | No | Optional case-insensitive substring of the stock short name | |
| max_results | No | Maximum filings to fetch and return (default 50, cap 200) | |
| title_query | No | Optional case-insensitive substring of the filing title | |
| document_type | No | Optional exact file type, e.g. PDF, HTML, XLS, DOC |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes | The filings matching the window and filters. |