Understanding the OpenClaw Skill for Public Holidays API

What is the OpenClaw Public Holidays Skill?

The OpenClaw skill 'apipick-public-holidays' is a specialized tool designed to
query public holidays for any country and year using the apipick Public
Holidays API. This skill provides a streamlined way to access holiday
information for over 100 countries, making it invaluable for planning,
scheduling, and cultural awareness applications.

Core Functionality

At its core, this skill allows users to retrieve comprehensive holiday
information through a simple API call. The skill supports ISO 3166-1 alpha-2
country codes, ensuring standardized identification across different nations.
Whether you need to find holidays for the United States, Japan, Germany, or
any other supported country, this skill provides accurate and up-to-date
information.

Key Features

• Support for 100+ countries worldwide
• Ability to query specific years or use the current year by default
• Comprehensive holiday data including official names and dates
• Cost-effective with only 1 credit per request
• Easy integration with existing systems

Technical Implementation

The skill operates through a straightforward API endpoint: GET
https://www.apipick.com/api/holidays. It requires authentication via an API
key (x-api-key header), which users can obtain for free from the apipick
website. The skill handles both the technical implementation and user-friendly
aspects of holiday queries.

API Parameters

The skill accepts two main parameters:

• country (required): ISO 3166-1 alpha-2 code such as 'US', 'GB', 'CN', 'DE', or 'JP'
• year (optional): 4-digit year, defaulting to the current year if not specified

Response Format

When a query is successful, the API returns a structured JSON response
containing:

• Success status and HTTP code
• Country information and year queried
• Total number of holidays found
• Detailed list of holidays with dates and official names
• API usage information including credits used and remaining

Example Response

A typical response for a US holiday query in 2026 might include New Year's
Day, Independence Day, and Christmas Day, each with their respective dates and
official names.

Usage Scenarios

This skill proves valuable in numerous scenarios:

• Planning international business operations around local holidays
• Creating cultural awareness applications
• Scheduling events and meetings across different time zones
• Developing travel planning tools
• Educational applications about global cultures

Integration and Setup

To use this skill effectively, users need to:

1. Obtain an API key from apipick.com
2. Set up the APIPICK_API_KEY environment variable
3. Configure the skill to handle country name conversions to ISO codes
4. Implement error handling for various API response codes

Cost and Credits

The skill operates on a credit-based system, with each request consuming 1
credit. Users receive credits upon registration and can monitor their usage
through the API response, which includes information about credits used and
remaining.

Conclusion

The OpenClaw 'apipick-public-holidays' skill represents a powerful tool for
accessing global holiday information through a standardized, reliable API. Its
ease of use, comprehensive coverage, and cost-effectiveness make it an
excellent choice for developers and businesses needing accurate holiday data
across multiple countries and years.

Related Skills

For users interested in similar functionality, OpenClaw offers related skills
for weather data, time zone information, and other location-based services,
all following similar integration patterns and quality standards.

Skill can be found at:
public-holidays/SKILL.md>