NZ GETS Open Tenders (Apify Actor)

Monitors open tenders / RFQs listed on New Zealand’s Government Electronic Tender Service (GETS) by fetching the official RSS feed only. Applies optional keyword, region, and category filters, then pushes structured records to the Actor dataset (pay-per-result ready).

Data source: GETS / NZ Government Electronic Tender Service official RSS (ExternalRSSFeed.htm). This Actor does not scrape tender detail HTML pages or ExternalIndex.htm.

Output fields

Each dataset item:

Field	Description
rfxId	GETS RFx ID
title	Tender title
organisation	Issuing organisation (agency name)
openDate / closeDate	As published on the feed
categories	Category code + label strings
region	Region(s); multi-region joined with ;
overview	Short overview text from the feed
url	Link to the GETS tender details page
publishedAt	Feed pubDate / dc:date

No personal contacts are invented or scraped. Organisation names from the public feed are included.

Inputs

Input	Type	Notes
keywords	string / array	Match title or overview (case-insensitive). Multiple = OR.
regions	string / array	Substring on Region (e.g. Auckland, New Zealand). Multiple = OR.
categories	string / array	Substring on category codes/labels (e.g. 81110000, Computer). Multiple = OR.
maxItems	integer	Cap matched items (default 500, max 5000).

Filter types are ANDed; values within a type are ORed.

Example input

{
  "keywords": ["software", "cloud"],
  "regions": ["Auckland", "New Zealand"],
  "categories": ["81110000", "Computer"],
  "maxItems": 50
}

Local development

Requirements: Node.js 18+.

cd /team/projects/01-apify-scrapers/src/nz-gets-open-tenders
npm install
npm test          # offline unit tests (fixture RSS)
npm run smoke     # optional live feed smoke (needs network)

Run the Actor locally with Apify CLI (optional):

apify run -p
# or with input JSON:
# echo '{"keywords":["construction"],"maxItems":5}' > storage/key_value_stores/default/INPUT.json
# apify run

Without Apify CLI, npm start expects Apify runtime env (storage). Prefer npm test / npm run smoke for local checks.

Live smoke one-liner

node scripts/smoke.js --max 3
# optional allowlisted override: GETS_FEED_URL=https://www.gets.govt.nz/ExternalRSSFeed.htm node scripts/smoke.js --keyword computer --max 2

Security notes

• No Store feedUrl input — the Actor always fetches the official GETS RSS URL (www.gets.govt.nz … ExternalRSSFeed.htm). Local/dev may set GETS_FEED_URL but it must pass the same allowlist (blocks SSRF).
• RSS response body is capped at 8 MiB before parse.

Deploy to Apify

1. Owner creates/logs into an Apify account (see /team/OWNER_QUEUE.md).
2. Install Apify CLI, then from this folder:

apify login
apify push

3. In Console: set Actor to pay-per-result (or pay-per-event), publish to Store when ready.
4. Monetization / Store listing is an owner step — no credentials are stored in this repo.

Known limits

• RSS only — no full tender documents, attachments, or Q&A threads.
• Feed volume is typically a few hundred open items; structure changes fail the run loudly (channel title / items / content-type checks).
• Region strings may list many regions separated by ; (from <br> in the feed).
• Overview text is from the feed with purchaser emails and phone numbers redacted (GETS republication condition). Other prose is kept.
• Be a polite client (User-Agent identifies this Actor; reasonable timeouts).

Privacy

This Actor retrieves a public open-tender RSS feed. Filters are user-supplied. Results may include text already published on GETS. Purchaser emails and phone numbers are redacted from overview text. Processing runs on Apify. The creator does not sell user inputs for unrelated purposes.

Attribution

Tender notices are Crown copyright material published on GETS and owned by the Ministry of Business, Innovation and Employment (MBIE), reused with attribution under the GETS terms / NZGOAL framework referenced there. Source feed: GETS open tenders RSS.

This Actor is not affiliated with or endorsed by MBIE or GETS. Do not use GETS or government logos. For complete tender documents, register and respond on GETS itself — each result includes the live GETS url plus RFx ID, title, organisation (purchaser), and close date. Purchaser emails and phone numbers are removed from overview.

Tech

• Node.js + official apify SDK
• rss-parser for RSS 2.0
• No Crawlee / no HTML page crawls