🎉 Public Holidays Worldwide Scraper

🚀 Pull public holidays for 100+ countries by year: date, local + English name, type, counties affected, and launch year.

🕒 Last updated: 2026-05-07 · 📊 11 fields per record · 100+ countries · public, bank, optional, school holidays · multi-country runs and year ranges

The Public Holidays Worldwide Scraper pulls public-holiday calendars for 100+ countries, year by year. Output includes the date, local-language name, English name, country code, holiday type (public/bank/optional/school), counties affected for sub-national holidays, and the launch year for newer observances.

The dataset covers every country supported by the Nager.Date global holiday API, which spans 100+ nations including all G20 economies, all EU member states, and most Latin American, Asian, African, and Oceanic countries. Multi-country runs and multi-year date ranges are supported.

🎯 Target Audience	💡 Primary Use Cases
HR, payroll, calendar apps, travel platforms, schedulers, internal company tools, journalists	HR leave-balance calculation, payroll cutoffs, corporate calendar overlays, travel-app country pages, retail planning

---

📋 What the Public Holidays Worldwide Scraper does

Five filtering workflows in a single run:

• 🌍 Multi-country runs. Pass any ISO-2 country code or leave empty for every supported country.
• 📅 Year ranges. Single year or YYYY:YYYY range for multi-year exports.
• 🏷️ Type metadata. Public, bank, optional, school, observance flags.
• 🗺️ County-level holidays. Sub-national holiday flags for federal countries.
• 📅 Launch year. When a holiday was first established (when known).

💡 Why it matters: clean, server-side filtering and fresh data on every run.

---

🎬 Full Demo

🚧 Coming soon: a 3-minute walkthrough showing how to go from sign-up to a downloaded dataset.

---

⚙️ Input

Input	Type	Default	Behavior
maxItems	integer	10	Records to return. Free plan caps at 10, paid plan up to 1,000,000.
country	string	"US"	ISO-2 code. Empty = every supported country.
yearStart	integer	2026	Earliest year to fetch.
yearEnd	integer	0	Latest year. Empty = same as yearStart.

Example: every US holiday in 2026.

{
    "maxItems": 50,
    "country": "US",
    "yearStart": 2026
}

Example: every holiday in every country in 2026.

{
    "maxItems": 2000,
    "yearStart": 2026
}

---

📊 Output

Each record contains 11 fields. Download as CSV, Excel, JSON, or XML.

🧾 Schema

Field	Type	Example
📅 date	string	"2026-12-25"
📛 localName	string	"Christmas Day"
📛 name	string	"Christmas Day"
🆔 countryCode	string	"US"
📅 year	number	2026
🟢 global	boolean	true
📌 fixed	boolean	true
🏷️ types	array	["Public"]
🗺️ counties	array	null
📅 launchYear	number	null

📦 Sample records

---

✨ Why choose this Actor

	Capability
🌍	100+ countries. All G20 + EU + most LATAM/Asia/Africa.
📅	Year ranges. Multi-year exports in a single run.
🏷️	Type-tagged. Public, bank, optional, school, observance flags.
🗺️	County-level. Sub-national holidays for federal nations.
⚡	Fast. Hundreds of holidays in seconds.

---

📈 How it compares to alternatives

Approach	Cost	Coverage	Refresh	Filters	Setup
⭐ This Actor	$5 free credit	100+ countries	Live per run	country, year range	⚡ 2 min
Manual gov website scraping	Free	Per-country	Variable	DIY	🐢 Days
Calendarific	$$/month	Similar	Live	Yes	🐢 Account
Hard-coded calendars	Free	Stale	Manual	None	🐢 Maintenance

---

🚀 How to use

1. 📝 Sign up. Create a free account with $5 credit (takes 2 minutes).
2. 🌐 Open the Actor. Find the Public Holidays Worldwide Scraper on the Apify Store.
3. 🎯 Set input. Pick filters and maxItems.
4. 🚀 Run it. Click Start.
5. 📥 Download. Grab results in the Dataset tab as CSV, Excel, JSON, or XML.

⏱️ Total time from signup to dataset: 3-5 minutes. No coding required.

---

💼 Business use cases

👥 HR + Payroll Leave-balance calculations Payroll cutoff scheduling Compliance with sub-national holidays Multi-country team calendars	📅 Calendars + Schedulers Calendar overlay backgrounds Meeting-scheduler avoidance Travel-day blocking Out-of-office defaults
🛒 Retail + Operations Holiday-week stock planning Logistics cutoffs Marketing campaign timing Customer-service staffing	✈️ Travel Apps Country travel-day previews Best-time-to-visit indicators Local festival listings Banking-day notices

---

🔌 Automating Public Holidays Worldwide Scraper

Control the scraper programmatically:

• 🟢 Node.js. Install the apify-client NPM package.
• 🐍 Python. Use the apify-client PyPI package.
• 📚 See the Apify API documentation for full details.

The Apify Schedules feature lets you trigger this Actor on any cron interval.

---

🌟 Beyond business use cases

Data like this powers more than commercial workflows.

🎓 Research and academia Cross-cultural calendar studies Reproducible holiday snapshots Course materials with current data Comparative public-policy research	🎨 Personal and creative Personal calendar overlays Travel planning side projects Holiday-themed newsletters Hobbyist year-overview tools
🤝 Non-profit and civic NGO event-planning Civic calendar projects Cultural-heritage cataloging Educational outreach	🧪 Experimentation Train scheduler models Prototype calendar-aware agents Test travel-app features Build event-recommendation engines

---

🤖 Ask an AI assistant about this scraper

Open a ready-to-send prompt in the AI of your choice:

• 💬 ChatGPT
• 🧠 Claude
• 🔍 Perplexity
• 🅒 Copilot

---

❓ Frequently Asked Questions

🧩 How does it work?

Provide a country code (or leave empty) and year (or year range). The Actor calls the Nager.Date public-holiday API and emits one record per holiday.

🌍 Which countries are covered?

100+, including all G20 economies, all 27 EU member states, and most Latin American, Asian, African, and Oceanic countries. Empty country = every supported country.

📊 How many fields per record?

11, including date, local name, English name, country code, year, type tags, fixed flag, global flag, counties, and launch year.

🏷️ What do the type tags mean?

Public = federal observance, Bank = bank closure, Optional = some employers, School = school closure, Observance = cultural but not work-affecting.

🗺️ What are counties?

Sub-national codes (e.g. ISO 3166-2). When global is false, the holiday only applies in the listed counties or states.

🔁 Can I schedule runs?

Yes. Schedule annually to capture next year's holidays as they're published.

⚖️ Is this data free to use?

Yes. The underlying Nager.Date dataset is open source and free for commercial use.

💳 Do I need a paid Apify plan?

No. The free plan covers preview runs.

🆘 What if a run fails?

Apify retries transient errors. Per-country failures are logged and other countries continue.

📅 Does it cover religious + cultural festivals?

Yes when those are official public holidays. For purely cultural festivals, results vary by country.

---

🔌 Integrate with any app

Public Holidays Worldwide Scraper connects to any cloud service via Apify integrations:

• Make - Automate multi-step workflows
• Zapier - Connect with 5,000+ apps
• Slack - Get run notifications
• Airbyte - Pipe data into your warehouse
• GitHub - Trigger runs from commits
• Google Drive - Export datasets to Sheets

---

🔗 Recommended Actors

• 🌍 REST Countries - Country reference data with capital, currency, flag
• 🌐 GeoNames Places + Postal Codes - 12M+ places with admin hierarchy
• 🌍 Open-Meteo Weather - Global weather forecasts and historical climate
• 🏥 WHO Global Health Indicators - 9,000+ WHO health metrics
• 🌏 World Bank Funded Projects - World Bank-financed development projects

💡 Pro Tip: browse the complete ParseForge collection for more reference-data scrapers.

---

🆘 Need Help? Open our contact form to request a new scraper, propose a custom data project, or report an issue.

---

⚠️ Disclaimer: this Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by Nager.Date, its contributors, or any country's official public-holiday authority. All trademarks mentioned are the property of their respective owners. Only publicly available open data is collected.