Public Holidays API: 100+ Countries, Any Year & Long Weekends

Get official public and bank holidays for more than 100 countries and any year, in a clean one-row-per-holiday format. Each row includes the date, weekday, English and local name, holiday types (public, bank, school, authorities, optional, observance), a nationwide or regional flag with the regions affected, and days from today. Optionally add long weekends with suggested bridge days. Data comes from the free, open-source Nager.Date API. No login, no API key.

Who is it for?

• HR, payroll and workforce planning teams handling multiple countries.
• Ecommerce and marketing teams planning campaigns around holidays.
• Logistics, support and scheduling tools that need working-day calendars.
• Travel businesses spotting long weekends for promotions.

How to use it

1. Add countries (2-letter codes like US, GB, DE, BR, or ALL).
2. Add one or more years.
3. Optionally turn on long weekends, nationwide only, upcoming only, or pick holiday types.
4. Click Start, or schedule it yearly or monthly.

Input example

{"countries": ["US", "CO"], "years": ["2026", "2027"], "includeLongWeekends": true}

Output example

{"type": "holiday", "countryCode": "US", "country": "United States", "date": "2026-01-01", "weekday": "Thursday", "name": "New Year's Day", "localName": "New Year's Day", "holidayTypes": ["Public", "Bank"], "nationwide": true, "regions": [], "daysFromToday": -298}

Long-weekend rows (type: long-weekend) include the start and end dates, the day count and any bridge days needed.

How much does it cost?

Pay-per-event: a very small fee per holiday or long weekend returned, plus a tiny per-run start fee, with no subscription and no separate platform usage costs. For example, 1,000 rows cost about $0.30, and a full year for one country is usually 10 to 40 rows. Unsupported countries are not charged. Set Maximum cost per run to cap your spending.

Use it through the API, integrations or AI agents

Run it from the Apify API, on a schedule, or connect it to Make, Zapier, n8n or Google Sheets. AI agents can find and call it through the Apify MCP server. Output is clean JSON with the same fields on every run.

FAQ

Is it legal? Yes. Holiday dates are public facts, and Nager.Date is an open-source project that offers its public API for free.

Which countries are supported? More than 100, including the US, UK, Canada, Australia, most of Europe and Latin America, Japan and China. Unsupported codes return a free error row.

Are regional holidays included? Yes. Regional holidays have nationwide: false and list their regions, like US-CA or DE-BY.

More tools from this developer

• SAM.gov Contract Opportunities Finder & Bid Alerts: federal contract opportunities and bid alerts
• Sitemap & URL Extractor: get every URL of a website from its sitemaps
• Website to Markdown for AI & RAG: turn web pages into clean Markdown for LLMs
• Tech Stack Detector: find what any website is built with
• Apple App Store Reviews Scraper: App Store reviews and ratings for any app
• ATS Jobs Scraper: jobs from Greenhouse, Lever, Ashby, Workable and more
• Website Screenshot: full-page, mobile and PDF screenshots in bulk
• PDF to Text & Markdown Extractor: extract text from PDFs for AI and search
• Domain WHOIS, DNS & SSL Checker: bulk domain, DNS, email security and SSL checks
• SEO Meta Tags & On-Page Audit: bulk on-page SEO audit with fixes
• Bulk URL Status & Broken Link Checker: status codes, redirect chains and broken links
• RSS & Atom Feed Reader: merge and filter many news feeds
• Hacker News Scraper: HN stories, comments and Who is hiring jobs
• Academic Paper Search: papers from Crossref, arXiv and PubMed
• SEC EDGAR Filings & Financials: 10-K, 10-Q, 8-K filings and company financials
• Apple Podcasts Scraper: podcast details and full episode lists
• App Store Top Charts & App Search: top free, paid and grossing app rankings
• ClinicalTrials.gov Scraper: search and export clinical trials
• USAspending Federal Awards: who won federal contracts and grants
• Grants.gov Opportunities: open and forecasted federal grants
• Weather Forecast & Alerts: 9-day forecasts for any city, plus U.S. alerts
• EU TED Tenders Scraper: European public procurement notices
• Bulk Domain Availability Checker: check which domains are free to register
• Product Recalls Scraper: FDA, CPSC and NHTSA vehicle recalls
• Federal Register Scraper: U.S. rules, notices and comment deadlines
• npm & PyPI Package Stats: downloads, versions and licenses for packages
• Open Library Books Scraper: book search and ISBN lookup
• UK Contracts Finder Scraper: UK public tenders and contract awards
• Wikipedia Scraper: articles, full text and page views
• Currency Exchange Rates (ECB): official latest and historical FX rates
• Barcode Product Lookup: EAN/UPC barcodes to product and nutrition data
• Global Company Registry Search (LEI): official company records and parents
• VIN Decoder (NHTSA): bulk vehicle specs from VINs
• PubMed Scraper: biomedical articles and abstracts
• US Address Geocoder (Census): lat/long, county and tract for U.S. addresses
• Remote Jobs Aggregator: remote jobs from Remote OK, Jobicy and Arbeitnow
• Hugging Face Hub Scraper: AI models, datasets and Spaces
• World Bank Indicators: GDP, population and 1,400+ indicators
• TV Shows & Episodes Scraper: TV shows, episodes, cast and schedules
• WordPress Plugins & Themes Scraper: plugin and theme installs and ratings
• US Nonprofit Search (IRS): tax-exempt organizations with size and category
• Music Metadata Scraper (MusicBrainz): artists, albums, tracks and ISRCs
• Package Stats: crates.io, RubyGems, Packagist & NuGet: Rust, Ruby, PHP and .NET package stats
• FDA Drug Labels & NDC Scraper: official drug labels and NDC codes