{ "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 } } } } } } } } } }