NZ Public Holidays Scraper

NZ Public Holidays Scraper pulls structured data from Nager.Date Holiday API and returns it as a clean dataset you can export as JSON, CSV or Excel. It returns every New Zealand public holiday for the year you choose, with the official date, English and local names, the holiday type and whether the day applies nationally or only in certain regions. Useful for rosters, payroll, booking flows, retail trading-hours planning and calendar feeds.

No API key, no login. Click Start and it works with the prefilled input.

What does NZ Public Holidays Scraper do?

It queries Nager.Date Holiday API and returns one row per record, with only the fields that matter. Runs on the Apify platform, so you get an API endpoint, scheduling, monitoring and integrations (Zapier, Make, Google Sheets, webhooks) without maintaining any infrastructure.

Why use it?

• Nager.Date Holiday API data without the plumbing: no proxy setup, no pagination code, no scraping maintenance.
• Schedule it to monitor changes daily or weekly and trigger alerts on new records.
• Feed it straight into a spreadsheet, database, or an AI agent via the Apify API or MCP server.
• Runs in seconds and returns a typed dataset that is ready for analysis.

How to use it

1. Click Try for free / Start.
2. Leave the default input to see a sample run, or type your own values (see Input below).
3. Press Start and wait a few seconds.
4. Open the Output tab and download as JSON, CSV, Excel or HTML.

Input

Field	Type	Default	Description
year	integer	2026	Calendar year to fetch public holidays for.
countryCode	string	"NZ"	Two-letter country code. NZ for New Zealand, AU for Australia, GB for the United Kingdom.
maxResults	integer	50	Maximum number of public holidays to return.

Example input:

{
  "year": 2026,
  "countryCode": "NZ",
  "maxResults": 5
}

Output

One item per record. Sample:

{
  "holiday_date": "2026-01-01",
  "holiday_name": "New Year's Day",
  "local_name": "Day after New Year's Day",
  "holiday_types": "Public",
  "is_global": true,
  "is_fixed": false
}

You can download the dataset in various formats such as JSON, HTML, CSV, or Excel.

Data fields

Field	Type	Meaning
holiday_date	string	Date
holiday_name	string	Holiday
local_name	string	Local Name
holiday_types	string	Type
is_global	boolean	Nationwide
is_fixed	boolean	Fixed Date
counties	string	Regions
country_code	string	Country
holiday_year	integer	Year
launch_year	integer	Launched

How much does it cost to run?

This Actor uses pay-per-event pricing: you pay per result item pushed to the dataset, and nothing for an empty run. Each run is a few seconds of compute, so typical costs are fractions of a cent per run, and the Apify free tier covers plenty of testing.

Tips and advanced options

• Raise maxResults for a bigger pull; the Actor pages through the source for you.
• Schedule it (e.g. every morning) and combine with a webhook to get only the new records.
• Add the Actor to an AI agent through the Apify MCP server for natural-language queries.

FAQ, disclaimers and support

• Is this legal? It uses publicly available data from Nager.Date Holiday API. You are responsible for how you use the data and for complying with the source's terms.
• It returned nothing? Pick a year between 2000 and 2100 and a two-letter country code such as NZ, AU or GB.
• Something broken? Open an issue on the Actor's Issues tab. Data sources change and get fixed quickly.
• Need a custom variant (extra fields, a different source, a scheduled report)? Get in touch through the Issues tab.