Pricing
Pay per usage
Search public holidays, long weekends, and upcoming holidays for 100+ countries. Uses the free Nager.Date API with ISO country codes. Get holiday dates, types, and regional details.
You can access the Country Public Holiday Search 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.
1from apify_client import ApifyClient2
3# Initialize the ApifyClient with your Apify API token4# Replace '<YOUR_API_TOKEN>' with your token.5client = ApifyClient("<YOUR_API_TOKEN>")6
7# Prepare the Actor input8run_input = { "countryCode": "US" }9
10# Run the Actor and wait for it to finish11run = client.actor("ryanclinton/country-holidays-search").call(run_input=run_input)12
13# Fetch and print Actor results from the run's dataset (if there are any)14print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])15for item in client.dataset(run["defaultDatasetId"]).iterate_items():16 print(item)17
18# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-startThe Apify API client for Python is the official library that allows you to use Country Public Holiday Search API in Python, providing convenience functions and automatic retries on errors.
Install the apify-client
$pip install apify-clientOther API clients include: