Pricing

from $0.50 / 1,000 holiday scrapeds

Public Holidays Scraper

Get public holidays for 100+ countries via Nager.Date. Returns date, English name, local name, country code, fixed/movable flag, type (Public/Bank/School/Authorities/Optional/Observance), counties (US states, DE Länder, etc.). For HR, scheduling, calendar apps.

Pricing

from $0.50 / 1,000 holiday scrapeds

Rating

0.0

(0)

Developer

Gio

Actor stats

Bookmarked

Total users

Monthly active users

9 days ago

Last modified

Categories

E-commerce

Developer tools

You can access the Public Holidays Scraper programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in Integrations settings in Apify Console.

Python

JavaScript

CLI

OpenAPI

HTTP

MCP

{
  "openapi": "3.0.1",
  "info": {
    "version": "0.0",
    "x-build-id": "pixroHn1jmNc5WhH0"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/gio21~public-holidays-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-gio21-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/gio21~public-holidays-scraper/runs": {
      "post": {
        "operationId": "runs-sync-gio21-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/gio21~public-holidays-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-gio21-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": {
          "countries": {
            "title": "Country codes (ISO-2)",
            "uniqueItems": true,
            "type": "array",
            "description": "Two-letter country codes (BR, US, DE, JP, etc.). Empty = list all supported.",
            "items": {
              "type": "string"
            }
          },
          "years": {
            "title": "Years",
            "uniqueItems": true,
            "type": "array",
            "description": "Years to pull holidays for. Empty = current year only.",
            "items": {
              "type": "string"
            }
          },
          "debug": {
            "title": "Debug logs",
            "type": "boolean",
            "description": "Verbose logging.",
            "default": false
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

Public Holidays Scraper OpenAPI definition

OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.

OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.

By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.

You can download the OpenAPI definitions for Public Holidays Scraper from the options below:

OpenAPI.json

If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.

You can also check out our other API clients:

Public Holidays Scraper API in Python

Public Holidays Scraper API in JavaScript

Public Holidays Scraper API through CLI

Public Holidays Scraper API

Public Holidays Scraper

parseforge/nager-public-holidays-scraper

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.

ParseForge

Public Holidays Worldwide Scraper

parseforge/public-holidays-scraper

Pull public holidays for 100+ countries by year. Returns date, local name, English name, country code, type (public/bank/optional), counties affected, and launch year. Multi-country runs and year ranges. Useful for HR, payroll, calendaring, and travel apps.

ParseForge

Public Holiday Scraper - Global Holidays by Country

vernacular_reservoir/public-holiday-scraper

Fetch public holidays for 100+ countries worldwide via Nager.Date API. Get holiday name, date, type and regional info. Supports current year, any year from 2000-2030, and upcoming holidays mode. Perfect for HR systems, calendar apps and scheduling tools. No API key required.

Aleksandrs

Public Holidays API

automation-lab/public-holidays-scraper

Get public holidays for any country and year. Supports 121 countries, long weekends, worldwide holidays, and bulk queries. Uses the free Nager.Date API — no proxy, no API key needed.

Stas Persiianenko

Japan Public Holidays

shiokoshi356/japan-holidays-data

Japan public holidays data. National holidays with dates and names in Japanese and English. Updated annually. MIT licensed open data.

Shiokoshi356

UK Bank Holidays Scraper

parseforge/gov-uk-bank-holidays-scraper

Export official UK bank holidays for England-Wales, Scotland, and Northern Ireland. Returns title, date, substitute-day notes, bunting flag per division per year. Sourced from the GOV.UK open data feed.

ParseForge

Public Holidays API

easyapi/public-holidays-api

Access holiday data from over 100 countries with our Public Holiday API! Query public holidays and long weekends effortlessly. With an IoT endpoint to check if today is a holiday, it's perfect for developers. Get started today and enhance your applications with up-to-date holiday information!

EasyApi

Zillow School Scraper

axlymxp/zillow-school-scraper

Scrapes school data from Zillow's mobile API within specified geographic boundaries. Returns school name, address, rating, type (public/private/charter), level (elementary/middle/high), coordinates and other details. Allows filtering by school rating, level and type.

axly

Us Business Search

great_pistachio/us-business-search

Search official Secretary of State databases across US states. Look up businesses by name, get entity type, status, formation date, officers, registered agent, addresses. Supports NY and FL. Public government data.

Saturnin Pugnet

5.0

Wikimedia On This Day Scraper

compute-edge/wikimedia-onthisday-scraper

Extract historical events, births, deaths, and holidays from Wikimedia's On This Day feed for any date. Includes article summaries and thumbnails. Great for content creation, history apps, and education.