📅 Public Holidays Scraper — Any Country & Year

Get the official public holidays for any country and year as clean, structured data — the date, the local-language name, the English name, the day of the week, the holiday type, whether it is national or regional, and exactly which states/counties it applies to. Pull one country or dozens, for a single year or many, in a single run. It is the fastest way to build a reliable holiday calendar for scheduling, payroll and planning.

The actor is powered by the public Nager.Date API, which covers 100+ countries, so it is fast and reliable with no browser, no login and no API key. Export to JSON/CSV/Excel, run on a schedule, call via API, or connect to Make, Zapier or n8n.

🔎 What is the Public Holidays Scraper?

Knowing which days are official holidays — and where — matters for anything time-sensitive: calculating working days and pay periods, planning deliveries and support coverage, scheduling campaigns, or simply showing the right days off in an app. Maintaining that data by hand across countries is tedious and error-prone.

This actor does it for you. Provide a list of ISO country codes and the years you care about, and it returns every official public holiday as structured rows — with both the native-language name and the English name, a day-of-week label, the holiday type, a national-vs-regional flag, and the list of affected regions for holidays that only apply to certain states or counties. It is ideal for populating HR systems, payroll engines, booking platforms and calendar apps with authoritative, up-to-date holiday data.

What data does it extract?

• Date — the holiday date in YYYY-MM-DD
• Year — the year queried
• Day of week — Monday…Sunday, computed from the date
• Local name — the holiday name in the country's own language
• Name — the English name of the holiday
• Country code — ISO 3166-1 alpha-2 (e.g. US, DE, GB)
• Country — full country name
• Fixed — whether the holiday falls on the same calendar date every year
• Global — true if national, false if it applies only to certain regions
• Counties — the specific states/counties affected (for regional holidays)
• Launch year — the year the holiday was first observed, where known
• Types — one or more of Public, Bank, School, Authorities, Optional, Observance

⬇️ Input

Field	Type	Description
countries	array	ISO 3166-1 alpha-2 country codes, e.g. US, DE, GB. One or many. Defaults to US.
years	array	Years to fetch, e.g. 2026. One or many. Defaults to the current year.

Example input

{
  "countries": ["US", "DE", "GB"],
  "years": ["2026", "2027"]
}

⬆️ Output

One clean row per holiday (view as a table, or export JSON / CSV / Excel):

{
  "date": "2026-01-01",
  "year": 2026,
  "day_of_week": "Thursday",
  "local_name": "New Year's Day",
  "name": "New Year's Day",
  "country_code": "US",
  "country": "United States",
  "fixed": false,
  "global": true,
  "counties": [],
  "launch_year": null,
  "types": ["Public"]
}

A regional example — a holiday that only applies to certain German states — returns the affected regions in counties:

{
  "date": "2026-01-06",
  "year": 2026,
  "day_of_week": "Tuesday",
  "local_name": "Heilige Drei Könige",
  "name": "Epiphany",
  "country_code": "DE",
  "country": "Germany",
  "fixed": true,
  "global": false,
  "counties": ["DE-BW", "DE-BY", "DE-ST"],
  "launch_year": null,
  "types": ["Public"]
}

💡 Use cases

• 🗓️ HR & payroll — calculate working days, leave entitlements and pay periods correctly for each country and region.
• 🚚 Logistics & operations — plan shipping, staffing and support coverage around closures across markets.
• 📆 Calendar & booking apps — automatically show local public holidays and block unavailable dates.
• 🤖 Automation — feed holiday data into Make/Zapier/n8n workflows, ERPs and scheduling tools.

❓ FAQ

How do I get public holidays for a country? Add ISO country codes to countries and the years to years, then Run. You get one structured row per holiday.

Do I need an API key or login? No. It uses the public Nager.Date API — just provide country codes and years.

Which countries are supported? 100+ countries, addressed by ISO 3166-1 alpha-2 code (e.g. US, DE, GB, FR, JP).

Can I fetch multiple countries and years at once? Yes — pass arrays for both countries and years and the actor iterates over every combination.

Does it include regional (state/county) holidays? Yes. The global flag tells you if a holiday is national, and counties lists the specific regions a non-national holiday applies to.

Are the holiday names localized? Yes — you get both the local_name (native language) and the English name.

What is the difference between the holiday types? types can include Public, Bank, School, Authorities, Optional and Observance, so you can filter to only the categories relevant to your use case.

Can I run it on a schedule or via API? Yes — schedule it (e.g. once a year to refresh next year's calendar), call it via the API/SDK, or connect it to Make, Zapier or n8n.

How does pricing work? Pay per holiday returned — no subscription, no fixed monthly fee.

Is it legal? It uses the public Nager.Date API and returns non-personal calendar data. Use it responsibly and in line with the provider's terms.

🔗 You might also like

• Open-Meteo Weather Scraper — global weather forecasts for planning.
• Currency Exchange Rates Scraper — live and historical FX rates.
• IP Geolocation Scraper — country, city, timezone & ISP from an IP.
• Google News Scraper — headlines by keyword and country.

---

Keywords: public holidays scraper, holiday api, bank holidays, national holidays, country holidays, holiday calendar, working days, business days, payroll holidays, hr scheduling, nager date, holidays by country, regional holidays, holiday data, calendar data, days off, statutory holidays, public holiday api, holiday dataset, observances