Market Intelligence

Announcements

Search 64,000+ NZX market announcements (2017-2026) with deep full-text search across titles AND 62,500+ extracted PDF documents. Find any mention of a topic, company, or event across 10 years of NZX filings. Supports cursor-based pagination via ?after= and ?before= params — responses include meta.next_cursor, meta.prev_cursor, and meta.has_more when using cursor mode. Server uses parseCursorPagination() + buildCursorMeta() helpers.

get/announcements

Request

  • Base URL: https://nzxplorer.co.nz/api/v1
  • URL: https://nzxplorer.co.nz/api/v1/announcements
  • Auth: one of:
    • API key in header X-API-Key
    • API key in query parameter api_key

Query parameters

searchstring

Full-text search across announcement titles AND PDF document content (62,500+ PDFs extracted)

tickerstring

Filter by company ticker

typestring

Announcement type: SHINTR, GENERAL, MKTUPDTE, MEETING, SECISSUE, FLLYR, HALFYR, DVDEND

fromstring

Start date (YYYY-MM-DD)

tostring

End date (YYYY-MM-DD)

limitinteger

Results per page (default: 50)

offsetinteger

Pagination offset (default: 0)

afterstring

Cursor for next page (from meta.next_cursor). Switches to cursor-based pagination mode.

beforestring

Cursor for previous page (from meta.prev_cursor). Switches to cursor-based pagination mode.

Response

Announcements

dataunknown

Example response

{
  "meta": {
    "api_version": "v1"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.