# Public Holidays Scraper (`parseforge/nager-public-holidays-scraper`) Actor Scrape public holidays for 100+ countries from Nager.Date. Get holiday name, date, country code, type (public, bank, school, optional), counties affected, launch year, and global/local flags. Perfect for HR systems, payroll, scheduling apps, and travel planning. - **URL**: https://apify.com/parseforge/nager-public-holidays-scraper.md - **Developed by:** [ParseForge](https://apify.com/parseforge) (community) - **Categories:** Automation, Travel, Other - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ![ParseForge Banner](https://github.com/ParseForge/apify-assets/blob/ad35ccc13ddd068b9d6cba33f323962e39aed5b2/banner.jpg?raw=true) ## πŸŽ‰ Nager.Date Public Holidays Scraper > πŸš€ **Export public holidays for 100+ countries with names, dates, and types in seconds.** > πŸ•’ **Last updated:** 2026-05-26 Β· **πŸ“Š 11 fields** per record Β· **100+ countries Β· past, current, future years Β· 5+ holiday types** This Apify Actor extracts structured data from Nager.Date Public Holidays, returning clean JSON / CSV / Excel / XML datasets ready for analytics, integrations, or research workflows. Built by ParseForge for reliability and freshness. | 🎯 Target Audience | πŸ’‘ Primary Use Cases | |---|---| | Data analysts, engineers, researchers | Analytics pipelines, BI dashboards, datasets | | SaaS, fintech, marketing, ops teams | Lead gen, enrichment, monitoring | | Hobbyists, journalists, indie devs | Side projects, content, exploration | ### πŸ“‹ What the Nager.Date Public Holidays Scraper does - Queries the public Nager.Date Public Holidays API / feed and structures the response - Returns one record per item with 11 normalized fields - Supports filters configurable from the input schema - Outputs to CSV, Excel, JSON, XML via Apify dataset - Auto-limits to 10 items on the free plan; up to 1,000,000 on paid > πŸ’‘ **Why it matters:** clean, ready-to-query data without manual scraping, parsing, or babysitting an API client. ### 🎬 Full Demo (_🚧 Coming soon_) ### βš™οΈ Input
FieldTypeRequiredDescription
maxItemsintegerNoMax items to return (free: 10, paid: 1,000,000)
```json { "maxItems": 50 } ```` ```json { "maxItems": 1000 } ``` > ⚠️ **Good to Know:** the free plan caps results at 10 items per run. Upgrade to a paid plan to unlock the full dataset. ### πŸ“Š Output | Field | Type | Description | |---|---|---| | πŸ”Ή date | string | Nager.Date Public Holidays date field | | πŸ”Ή name | string | Nager.Date Public Holidays name field | | πŸ”Ή localName | string | Nager.Date Public Holidays localName field | | πŸ”Ή countryCode | string | Nager.Date Public Holidays countryCode field | | πŸ”Ή types | string | Nager.Date Public Holidays types field | | πŸ•’ scrapedAt | string | ISO timestamp of when the record was collected | | ❌ error | string | null | Error message if extraction failed | ```json { "date": "...", "name": "...", "scrapedAt": "2026-05-26T00:00:00.000Z", "error": null } ``` ### ✨ Why choose this Actor | Differentiator | Benefit | |---|---| | 🟒 Real-time public data | Always fresh, never cached | | 🟒 Structured output | Ready for BI, Excel, SQL imports | | 🟒 Pay-per-result pricing | Pay only for actual data collected | | 🟒 Apify-hosted runs | No servers, no maintenance | | 🟒 Free tier preview | Test with 10 items before scaling | ### πŸ“ˆ How it compares to alternatives | Method | Setup time | Reliability | Maintenance | Cost | |---|---|---|---|---| | Manual scripting | Hours | Medium | High | Dev time | | Generic web scrapers | Hours | Low | High | Variable | | **This Actor** | **30 seconds** | **High** | **None** | **Pay-per-result** | ### πŸš€ How to use 1. [Create a free Apify account with $5 credit](https://console.apify.com/sign-up?fpr=vmoqkp) 2. Open this Actor and click **Try for free** 3. Configure the input (`maxItems` and any filters) 4. Click **Start** 5. Download the dataset as CSV / Excel / JSON / XML ### πŸ’Ό Business use cases **πŸ“Š Analytics & BI** β€” feed Nager.Date Public Holidays records into Looker, Tableau, Metabase for live dashboards. **🧠 Data enrichment** β€” append Nager.Date Public Holidays fields to your CRM / CDP records for better targeting. **πŸ” Monitoring** β€” schedule daily runs to detect new records, changes, or anomalies. **πŸ€– ML training data** β€” use structured Nager.Date Public Holidays data as features in models or test fixtures. ### πŸ”Œ Automating Nager.Date Public Holidays Scraper Connect via [Apify integrations](https://apify.com/integrations): **Make**, **Zapier**, **n8n**, **Slack**, **Discord**, **Airbyte**, **Google Drive**, **Google Sheets**, **GitHub**, **Webhook**, **REST API**. ### 🌟 Beyond business use cases **πŸ”¬ Research** β€” academics, journalists, policy researchers building public datasets. **🎨 Personal** β€” hobbyists tracking favorite topics, building personal projects, exploring data. **🀝 Non-profit** β€” NGOs, civic-tech, open-data initiatives needing structured Nager.Date Public Holidays extracts. **πŸ§ͺ Experimentation** β€” students, builders, indie devs prototyping with real-world data. ### πŸ€– Ask an AI assistant about this scraper Drop a link to this page into [ChatGPT](https://chat.openai.com), [Claude](https://claude.ai), [Perplexity](https://www.perplexity.ai), or [Copilot](https://copilot.microsoft.com) and ask: *"What can I do with the Nager.Date Public Holidays Scraper?"* ### ❓ Frequently Asked Questions **❓ Is the data fresh?** Yes. Every run queries Nager.Date Public Holidays in real time. No cached responses. **πŸ’° How does pricing work?** Pay-per-result: charged once per record collected. Free plan: 10 items per run preview. **🧾 What format is the output?** CSV, Excel, JSON, XML β€” Apify dataset supports all four. **πŸ” Do I need an API key?** No. Nager.Date Public Holidays public data only, no login required. **πŸ“ˆ What's the max I can scrape?** 1,000,000 items per run on paid plans. **⏱️ How long does a run take?** Typically seconds to minutes depending on `maxItems`. **🌍 Is this affiliated with Nager.Date Public Holidays?** No. Independent tool. Only publicly accessible data collected. **πŸ› οΈ What if a run fails?** You're never charged for failed records. Errors appear as `{error: "..."}` rows. **🀝 Can I use this commercially?** Yes, under Apify's standard terms and Nager.Date Public Holidays's public-data policies. **πŸ“ž Where do I get help?** [Open our contact form](https://tally.so/r/BzdKgA). ### πŸ”Œ Integrate with any app Apify's full integration list: **Make** Β· **Zapier** Β· **n8n** Β· **Slack** Β· **Discord** Β· **Webhook** Β· **REST API** Β· **GitHub** Β· **Airbyte** Β· **Google Drive** Β· **Google Sheets** Β· **Gmail** Β· **HubSpot** Β· **Pipedream**. ### πŸ”— Recommended Actors | Actor | Description | |---|---| | [Wikipedia On This Day Scraper](https://apify.com/parseforge/wikipedia-on-this-day-scraper) | Daily Wikipedia historical events | | [Public Holidays Scraper](https://apify.com/parseforge/nager-public-holidays-scraper) | Holidays for 100+ countries | | [SPDX Software Licenses Scraper](https://apify.com/parseforge/spdx-software-licenses-scraper) | Open-source license metadata | | [ISO Country Codes Scraper](https://apify.com/parseforge/iban-com-bank-codes-scraper) | IBAN + ISO country codes | > πŸ’‘ **Pro Tip:** browse the complete [ParseForge collection](https://apify.com/parseforge). **πŸ†˜ Need Help?** [Open our contact form](https://tally.so/r/BzdKgA) > **⚠️ Disclaimer:** independent tool, not affiliated with Nager.Date Public Holidays. Only publicly available data collected. # Actor input Schema ## `maxItems` (type: `integer`): Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000 ## `mode` (type: `string`): What to export. Public holidays for a year, the list of available countries, the next 365 days of holidays for a country, or long-weekend bridges. ## `countries` (type: `array`): ISO 3166-1 alpha-2 country codes. Required for holidays, upcoming, and longWeekends modes. Ignored for countries mode. ## `years` (type: `array`): Years to query for holidays / longWeekends modes. Range supported: 1975 - 2100. Defaults to the current year if empty. ## `counties` (type: `array`): Optional ISO 3166-2 sub-country codes (e.g. US-CA, US-NY, CA-ON). When set, holidays are filtered to those whose 'counties' field contains at least one of these. Leave empty for nationwide-only. ## Actor input object example ```json { "maxItems": 10, "mode": "holidays", "countries": [ "US" ], "years": [ "2025" ] } ``` # Actor output Schema ## `overview` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "maxItems": 10, "mode": "holidays", "countries": [ "US" ], "years": [ "2025" ] }; // Run the Actor and wait for it to finish const run = await client.actor("parseforge/nager-public-holidays-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`πŸ’Ύ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // πŸ“š Want to learn more πŸ“–? Go to β†’ https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "maxItems": 10, "mode": "holidays", "countries": ["US"], "years": ["2025"], } # Run the Actor and wait for it to finish run = client.actor("parseforge/nager-public-holidays-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("πŸ’Ύ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # πŸ“š Want to learn more πŸ“–? Go to β†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "maxItems": 10, "mode": "holidays", "countries": [ "US" ], "years": [ "2025" ] }' | apify call parseforge/nager-public-holidays-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=parseforge/nager-public-holidays-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Public Holidays Scraper", "description": "Scrape public holidays for 100+ countries from Nager.Date. Get holiday name, date, country code, type (public, bank, school, optional), counties affected, launch year, and global/local flags. Perfect for HR systems, payroll, scheduling apps, and travel planning.", "version": "1.0", "x-build-id": "hTKUo4HLyiZpmn6Qd" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~nager-public-holidays-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-nager-public-holidays-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/parseforge~nager-public-holidays-scraper/runs": { "post": { "operationId": "runs-sync-parseforge-nager-public-holidays-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/parseforge~nager-public-holidays-scraper/run-sync": { "post": { "operationId": "run-sync-parseforge-nager-public-holidays-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000" }, "mode": { "title": "Mode", "enum": [ "holidays", "countries", "upcoming", "longWeekends" ], "type": "string", "description": "What to export. Public holidays for a year, the list of available countries, the next 365 days of holidays for a country, or long-weekend bridges." }, "countries": { "title": "Countries", "uniqueItems": true, "type": "array", "description": "ISO 3166-1 alpha-2 country codes. Required for holidays, upcoming, and longWeekends modes. Ignored for countries mode.", "items": { "type": "string", "enum": [ "AD", "AL", "AM", "AR", "AT", "AU", "AX", "BA", "BB", "BD", "BE", "BG", "BJ", "BO", "BR", "BS", "BW", "BY", "BZ", "CA", "CD", "CG", "CH", "CL", "CN", "CO", "CR", "CU", "CY", "CZ", "DE", "DK", "DO", "EC", "EE", "EG", "ES", "FI", "FO", "FR", "GA", "GB", "GD", "GE", "GG", "GH", "GI", "GL", "GM", "GR", "GT", "GY", "HK", "HN", "HR", "HT", "HU", "ID", "IE", "IM", "IS", "IT", "JE", "JM", "JP", "KE", "KR", "KZ", "LI", "LS", "LT", "LU", "LV", "MA", "MC", "MD", "ME", "MG", "MK", "MN", "MS", "MT", "MX", "MZ", "NA", "NE", "NG", "NI", "NL", "NO", "NZ", "PA", "PE", "PG", "PH", "PL", "PR", "PT", "PY", "RO", "RS", "RU", "SC", "SE", "SG", "SI", "SJ", "SK", "SM", "SR", "SV", "TN", "TR", "UA", "UG", "US", "UY", "VA", "VE", "VN", "ZA", "ZW" ], "enumTitles": [ "Andorra (AD)", "Albania (AL)", "Armenia (AM)", "Argentina (AR)", "Austria (AT)", "Australia (AU)", "Γ…land Islands (AX)", "Bosnia and Herzegovina (BA)", "Barbados (BB)", "Bangladesh (BD)", "Belgium (BE)", "Bulgaria (BG)", "Benin (BJ)", "Bolivia (BO)", "Brazil (BR)", "Bahamas (BS)", "Botswana (BW)", "Belarus (BY)", "Belize (BZ)", "Canada (CA)", "DR Congo (CD)", "Congo (CG)", "Switzerland (CH)", "Chile (CL)", "China (CN)", "Colombia (CO)", "Costa Rica (CR)", "Cuba (CU)", "Cyprus (CY)", "Czechia (CZ)", "Germany (DE)", "Denmark (DK)", "Dominican Republic (DO)", "Ecuador (EC)", "Estonia (EE)", "Egypt (EG)", "Spain (ES)", "Finland (FI)", "Faroe Islands (FO)", "France (FR)", "Gabon (GA)", "United Kingdom (GB)", "Grenada (GD)", "Georgia (GE)", "Guernsey (GG)", "Ghana (GH)", "Gibraltar (GI)", "Greenland (GL)", "Gambia (GM)", "Greece (GR)", "Guatemala (GT)", "Guyana (GY)", "Hong Kong (HK)", "Honduras (HN)", "Croatia (HR)", "Haiti (HT)", "Hungary (HU)", "Indonesia (ID)", "Ireland (IE)", "Isle of Man (IM)", "Iceland (IS)", "Italy (IT)", "Jersey (JE)", "Jamaica (JM)", "Japan (JP)", "Kenya (KE)", "South Korea (KR)", "Kazakhstan (KZ)", "Liechtenstein (LI)", "Lesotho (LS)", "Lithuania (LT)", "Luxembourg (LU)", "Latvia (LV)", "Morocco (MA)", "Monaco (MC)", "Moldova (MD)", "Montenegro (ME)", "Madagascar (MG)", "North Macedonia (MK)", "Mongolia (MN)", "Montserrat (MS)", "Malta (MT)", "Mexico (MX)", "Mozambique (MZ)", "Namibia (NA)", "Niger (NE)", "Nigeria (NG)", "Nicaragua (NI)", "Netherlands (NL)", "Norway (NO)", "New Zealand (NZ)", "Panama (PA)", "Peru (PE)", "Papua New Guinea (PG)", "Philippines (PH)", "Poland (PL)", "Puerto Rico (PR)", "Portugal (PT)", "Paraguay (PY)", "Romania (RO)", "Serbia (RS)", "Russia (RU)", "Seychelles (SC)", "Sweden (SE)", "Singapore (SG)", "Slovenia (SI)", "Svalbard and Jan Mayen (SJ)", "Slovakia (SK)", "San Marino (SM)", "Suriname (SR)", "El Salvador (SV)", "Tunisia (TN)", "TΓΌrkiye (TR)", "Ukraine (UA)", "Uganda (UG)", "United States (US)", "Uruguay (UY)", "Vatican City (VA)", "Venezuela (VE)", "Vietnam (VN)", "South Africa (ZA)", "Zimbabwe (ZW)" ] } }, "years": { "title": "Years", "type": "array", "description": "Years to query for holidays / longWeekends modes. Range supported: 1975 - 2100. Defaults to the current year if empty.", "items": { "type": "string" } }, "counties": { "title": "Counties (sub-country filter)", "type": "array", "description": "Optional ISO 3166-2 sub-country codes (e.g. US-CA, US-NY, CA-ON). When set, holidays are filtered to those whose 'counties' field contains at least one of these. Leave empty for nationwide-only.", "items": { "type": "string" } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```