Public Holidays Scraper - 200+ Countries, Any Year avatar

Public Holidays Scraper - 200+ Countries, Any Year

Pricing

$2.00 / 1,000 scraped holidays

Go to Apify Store
Public Holidays Scraper - 200+ Countries, Any Year

Public Holidays Scraper - 200+ Countries, Any Year

Fetches public holidays for 200+ countries and any year from 1975 to 2075, by country code and year, in bulk. Returns the date, weekday, weekend flag, local and English names, and nationwide or regional scope. For HR and payroll teams, scheduling app developers and logistics teams.

Pricing

$2.00 / 1,000 scraped holidays

Rating

0.0

(0)

Developer

Broke to Built

Broke to Built

Maintained by Community

Actor stats

0

Bookmarked

2

Total users

1

Monthly active users

15 days ago

Last modified

Features

Limited permissions

Share

Public Holidays Scraper — 200+ Countries, Any Year

Public holidays for over 200 countries and any year from 1975 to 2075: the date, the weekday, a weekend flag, the local and English names, and whether it is nationwide or restricted to particular regions.

No API key, no account. $0.002 per holiday — a country/year pair with no holidays is recorded and not charged.

Input

{ "country": "US", "year": 2026 }

Every country against every year, in one run:

{ "countries": ["US", "DE", "JP", "GB"], "years": [2026, 2027] }
FieldTypeNotes
countrystringISO 3166-1 alpha-2 — US, DE, JP.
countriesstring[]Bulk. Over 200 supported.
yearinteger1975–2075. Defaults to the current year.
yearsinteger[]Bulk. Every country is fetched for every year.

Output

{
"ok": true,
"country": "US",
"countryName": "United States",
"year": 2026,
"date": "2026-07-03",
"weekday": "Friday",
"isWeekend": false,
"localName": "Independence Day",
"name": "Independence Day",
"global": true,
"counties": null,
"fixed": false,
"launchYear": null,
"types": ["Public"]
}

What it gets right

  • ⭐ Duplicates are merged before you are billed. The upstream source genuinely repeats holidays — US 2026 returns Good Friday twice and Columbus Day twice, once nationwide and once regional. Passing that through would charge you twice for one holiday. Rows are de-duplicated by date and name, keeping the nationwide record and merging the county lists so no regional detail is lost.
  • Observed dates are real dates. Independence Day 2026 falls on a Saturday, so the US observes it on Friday 2026-07-03 — and that is what you get. This reports the calendar as observed, not an idealised one.
  • weekday and isWeekend are computed in UTC and asserted to agree with the date, so they cannot drift into decoration. They are the two fields every planner derives by hand.
  • Regional holidays keep their subdivisions. global: false always comes with a counties list, so a nationwide planner never mistakes a state holiday for a federal one.
  • localName is the local language — Tag der Deutschen Einheit, not a translation — with the English name alongside.

Example

A real run on 2026-10-31 with the input this page's form is prefilled with:

{
"country": "US",
"countries": [],
"years": []
}

It finished in 2 seconds and returned 15 results. It was charged for 15 holiday-scraped events ($0.03 on the Free plan). Each result has these fields (values are not shown here because they include people's names or contact details):

FieldType
okboolean
countrystring
countryNamestring
yearnumber
datestring
weekdaystring
isWeekendboolean
localNamestring
namestring
fixedboolean
globalboolean
countiesnull
launchYearnull
typesarray

Pricing

$0.002 per holiday returned. A full year for one country is about 17 rows — roughly 3 cents. An unsupported country code produces an ok: false record and is not charged.

Limits

  • 200 country × year combinations per run.
  • 1975–2075. Outside that range the input is rejected rather than silently returning nothing.
  • Public/bank holidays. Not observances, school terms or religious calendars beyond those a country designates public.
  • Historic years reflect today's best record, not contemporaneous law.

FAQ

Do I need an API key? No.

Why is Independence Day on the 3rd? Because that is the day it is observed in 2026. See above.

Which countries? Over 200, ISO alpha-2. An unsupported code returns a clear error.

Changelog

  • 2026-11-01: Page text only: an Example section from a real run. Code, output and price are unchanged.
  • 0.1 (2026-09-10) — first release. Country × year cross product, upstream duplicate merging, derived weekday/weekend, regional subdivisions preserved.

Who uses it

  • HR and payroll teams building holiday calendars for multi-country staff
  • Scheduling and booking apps blocking out non-working days
  • Marketing teams planning campaigns around regional holidays
  • Logistics and ops teams predicting closures by country and region
  • Developers who need a holiday table without managing an API key