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] }

Field	Type	Notes
country	string	ISO 3166-1 alpha-2 — US, DE, JP.
countries	string[]	Bulk. Over 200 supported.
year	integer	1975–2075. Defaults to the current year.
years	integer[]	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.

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

• 0.1 (2026-09-10) — first release. Country × year cross product, upstream duplicate merging, derived weekday/weekend, regional subdivisions preserved.