Public Holidays Scraper

hipersoft/public-holidays-scraper

Get public holidays for 200+ countries and any year: date, holiday name, local name, national vs regional, county/region codes, holiday type and fixed/moveable. Perfect for scheduling, HR, calendars and business planning. One row per holiday as JSON, CSV or Excel.

Run this scraper →See the API call

Total users

Monthly users

Total runs

Per holiday scraped

$0.0003

Last rebuilt

Oct 26, 2026

Overview

Get public holidays for 200+ countries and any year with the Public Holidays Scraper. Pick countries and years and export each holiday's date, name, local name, national vs regional status, county/region codes, type and whether it's fixed or moveable — one clean row per holiday as JSON, CSV or Excel.

Built for scheduling and calendar apps, HR and payroll, e-commerce planning, logistics and business operations, it turns official holiday calendars into a structured dataset.

What it does

🌍 200+ countries — fetch holidays for any supported country by ISO code, or all at once.
📅 Any year — pull one year or several in a single run.
🏷️ Rich detail — holiday name, local-language name, date, type and launch year.
🗺️ National vs regional — a global/national flag plus county/region codes for regional holidays.
🔁 Fixed vs moveable — know whether a holiday's date shifts each year.
📤 Export anywhere — JSON, CSV or Excel, or straight into a calendar, HR system or planner.

Example output

{
  "date": "2026-04-03",
  "name": "Good Friday",
  "localName": "Karfreitag",
  "countryCode": "DE",
  "year": 2026,
  "global": true,
  "fixed": false,
  "counties": [],
  "types": ["Public"]
}

How to use it

Add country codes (e.g. US, GB, DE) — or leave empty for all countries.
Add the years you want.
Set Max holidays and run. Download the results as JSON, CSV or Excel.

Input fields

Field	Description
Country codes	ISO 3166 alpha-2 codes; empty = all 200+ countries.
Years	One or more years (e.g. 2026, 2027); empty = current year.
Max holidays	Maximum holidays to collect (0 = no limit).

Output fields

date, year, name, localName, countryCode, global, fixed, counties, types, launchYear.

Popular use cases

Scheduling & calendars — block out holidays across regions in an app.
HR & payroll — build leave and working-day calendars per country.
E-commerce & logistics — plan campaigns and shipping around holidays.
Business operations — know office closures across multiple markets.
Data enrichment — flag holiday dates in an existing dataset.

FAQ

Do I need an account or key? No. Choose countries and years and run.

How many countries are supported? Over 200 — leave the country field empty to fetch them all in one run.

Does it show regional holidays? Yes — each holiday has a national/global flag and, where relevant, the county/region codes it applies to.

Can I export to Excel or Google Sheets? Yes — results download as JSON, CSV or Excel and integrate with Sheets, calendars and HR tools.

Official public holidays for 200+ countries — dates, names, regions and types — clean and export-ready for scheduling, HR and planning.

Input

Field	Type	Description
`countryCodes` Country codes	array	ISO 3166 alpha-2 country codes — e.g. 'US', 'GB', 'DE', 'SG', 'IN'. Leave empty to fetch all 200+ supported countries.
`years` Years	array	Years to fetch — e.g. 2026, 2027. Leave empty for the current year.
`maxItems` Max holidays	integer	Maximum number of holidays to collect (0 = no limit). Default: `0`

API

curl -X POST "https://api.apify.com/v2/acts/hipersoft~public-holidays-scraper/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "countryCodes": [
    "US",
    "GB",
    "DE"
  ],
  "years": [
    "2026"
  ]
}'

from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("hipersoft/public-holidays-scraper").call(run_input={
    "countryCodes": [
        "US",
        "GB",
        "DE"
    ],
    "years": [
        "2026"
    ]
})

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });
const run = await client.actor('hipersoft/public-holidays-scraper').call({
  "countryCodes": [
    "US",
    "GB",
    "DE"
  ],
  "years": [
    "2026"
  ]
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

Pricing

Event	Price	Paid plans from
Holiday scraped Charged for each holiday returned.	$0.0003	$0.0001

You pay only for what the run returns. Set a maximum cost per run and it stops cleanly at that limit.

Related scrapers

North Data Scraper

Look up European companies on North Data: legal name, former names, register number, address, founding date, LEI, business purpose, managing directors and officers, and recent register publications. Germany, UK, France, Austria and 20+ countries. Bulk lookups.

2,467 runs · 5 users · $0.004 / company

Website Content Crawler

Extract clean, readable content from any list of websites: page title, meta description, headings, main body text, word count and link/image counts. Optional same-domain crawl. Bulk-ready. Great for LLM/RAG ingestion, content audits and research.

206 runs · 20 users · $0.0024 / page scraped

SpyFu Domain Scraper

Bulk SEO and PPC reports for any domain from SpyFu: organic keywords, monthly SEO clicks and value, Google Ads budget, paid keywords, top keywords, competitors, top countries and monthly history. Competitor research for agencies. Export CSV/JSON.

185 runs · 7 users · $0.008 / domain report

Trustpilot Reviews Scraper

Scrape Trustpilot reviews and company ratings by company domain or Trustpilot URL: star rating, title, text, reviewer name & country, verification, date, company reply, plus company TrustScore and total reviews.

146 runs · 4 users · $0.0006 / review scraped

ACRA Singapore Company Registry Scraper

Search and export Singapore's full ACRA corporate registry: UEN, entity name, status, incorporation date, address, SSIC industry codes, officers, former names and audit firms. Filter by name, status, entity type or industry. Public open data, no setup.

138 runs · 10 users · $0.01 / company scraped

Wayback Machine Scraper

List every Internet Archive (Wayback Machine) snapshot of a URL or whole domain: timestamp, snapshot URL, status code, MIME type and content digest. Filter by date, status and dedupe. For SEO, OSINT and historical research. No setup.

135 runs · 15 users · $0.002 / snapshot scraped

Need a source that isn't here?

Send the site and the fields. We build it and you get it first.

Request a build