Public Holidays Scraper (Worldwide)

Public Holidays Scraper (Worldwide) — a fast, reliable public holidays scraper that needs no API key. You pay only for the results you get: failed or empty runs are always free.

This public holidays scraper runs on the Apify platform, so you can call it from the API, run it on a schedule, or export results to JSON, CSV, Excel, or Google Sheets.

What this scraper does

• Extracts structured public holidays data with no browser or API key required
• Returns clean JSON, one record per result — ready for sheets, databases, or apps
• Pay-per-result pricing: you are never charged for a run that returns nothing
• Runs on demand or on a schedule, and integrates with 5,000+ apps via the Apify API and webhooks

What data you get

Each result record includes fields such as:

• Date (date) — e.g. "2025-07-04"
• Year (year) — e.g. 2025
• Name (name) — e.g. "Independence Day"
• Local Name (localName) — e.g. "Independence Day"
• Country Code (countryCode) — e.g. "US"
• Global (global) — e.g. true
• Fixed (fixed) — e.g. false
• Launch Year (launchYear) — e.g. null
• Counties (counties) — e.g. null
• Types (types) — e.g. ["Public", "Bank"]
• Url (url) — e.g. null

Input

Field	Type	Description
countryCodes	array	ISO 3166-1 alpha-2 country codes to fetch public holidays for, e.g. US, GB, DE, FR. One task runs per (year...
years	array	Calendar years to fetch, as 4-digit values (strings or integers both work), e.g. 2024, 2025. Defaults to th...
maxResults	integer	Maximum number of holiday records to return for each (year x country) task. Nager.Date typically returns 10...
holidayTypes	array	Optional. Keep only holidays whose types include at least one of the selected values. Leave empty to keep all.
globalOnly	boolean	Optional. If true, keep only holidays observed nationwide (global=true) and drop regional/county-specific o...

Example output

{
  "type": "holiday",
  "date": "2025-07-04",
  "year": 2025,
  "name": "Independence Day",
  "localName": "Independence Day",
  "countryCode": "US",
  "global": true,
  "fixed": false,
  "launchYear": null,
  "counties": null,
  "types": [
    "Public",
    "Bank"
  ],
  "url": null,
  "scrapedAt": "2026-07-11T00:00:00Z"
}

Use cases

• Automate research and data collection
• Feed dashboards, sheets, and databases
• Enrich records in your CRM or app
• Monitor changes on a schedule

Pricing

This actor uses pay-per-result pricing at $0.0004 per record. There is no monthly fee and no start fee — and empty or failed runs cost $0, so you only ever pay for data you actually receive.

Frequently asked questions

Do I need an API key or account for the source? No. This public holidays scraper works out of the box with no API key required.

What happens if a run returns no results? You are not charged. Billing is per result, so empty or failed runs are free.

Can I run the public holidays scraper on a schedule? Yes. Use the Apify Scheduler to run it hourly, daily, or on any cron schedule, and get results by webhook or API.

What export formats are supported? Results can be exported as JSON, CSV, Excel, HTML, or pushed to Google Sheets, a database, or your own app via the Apify API.

Is the data structured? Yes. Every public holidays result is a clean, flat JSON record you can use immediately.