Public Holidays API — 100+ countries (no key)

Official public holidays for 100+ countries as a clean HTTP API (and MCP tool). Look up every holiday for a country and year, the upcoming ones, whether today is a holiday, long weekends (with the bridge days to take off), and basic country info — all keyless. Perfect for scheduling, payroll, delivery/SLA calculations, booking flows and agents that need to reason about the calendar. No API key. Pay per query.

• 📅 Holidays by year — every public holiday for a country in a given year (local + English names, date, global/regional).
• ⏭️ Upcoming — the next holidays for a country, or worldwide.
• ✅ Is today a holiday? — a quick boolean per country.
• 🌉 Long weekends — date ranges + which bridge days to take.
• 🌍 Country info & list — names, region, land borders, and all supported countries.
• 💵 Pay per query · no key.

The use case it was built for

Anything date-aware breaks on holidays: SLAs, payroll, "next business day", delivery estimates, booking availability, reminders. Instead of hard-coding calendars per country, ask this API. Give an agent (over MCP) the ability to answer "is the office open tomorrow in Spain?" or "when's the next long weekend in Argentina?".

Sample output (holidays, AR 2026)

{
  "ok": true, "country": "AR", "year": 2026, "count": 19,
  "holidays": [
    { "date": "2026-01-01", "localName": "Año Nuevo", "name": "New Year's Day",
      "countryCode": "AR", "global": true, "types": ["Public"] }
  ]
}

How to use

• HTTP API (Standby): POST or GET /holidays, /next, /is-today, /long-weekends, /country-info, /countries. GET / returns help. Example: GET /next?country=AR&limit=3.
• Normal run: pass { operation, country, year }; results land in the dataset + key-value store.
• MCP tool: expose it to your agent via Apify's MCP server.

Input

• operation — holidays · next · is-today · long-weekends · country-info · countries.
• country — 2-letter ISO code (AR, US, ES, BR…). Optional for next (worldwide) and countries.
• year — for holidays / long-weekends (default: current year). limit — cap next results.

Pricing

Per query from $0.005 (down to $0.002 on higher tiers). One call = one query.

Related Actors

• Open-Meteo Weather API — forecasts and history for the same planning use cases.

FAQ

Which countries? 100+ — call countries for the full list. Use 2-letter ISO codes.

Are regional/state holidays included? Holidays carry a global flag and (where relevant) county codes, so you can filter national vs regional.

Do I need a key? No.

Notes & limits

Data comes from Nager.Date (community-maintained, widely used). Always sanity-check against local sources for legally binding decisions.