公開 祝日 API
100以上の国と任意の年の祝日を、1回のAPIコールでクエリできます。完全ローカル計算 — 外部データソースなし、レート制限の不意打ちもありません。
統合ガイド
スニペットをコピーし、APIキーを差し替えて実行するだけ。任意のHTTPクライアントで動作します — 以下にcURL、JavaScript、Pythonの例を掲載。
/api/holidayshttps://www.apipick.comGet all public holidays for a country and year
countrystring必須ISO 3166-1 alpha-2 country code US
yearinteger任意4-digit year (defaults to current year) 2026
curl -X GET "https://www.apipick.com/api/holidays" \
-H "x-api-key: YOUR_API_KEY"{
"success": true,
"code": 200,
"message": "Holidays retrieved successfully",
"data": {
"country": "US",
"country_name": "United States",
"year": 2026,
"total": 11,
"holidays": [
{
"date": "2026-01-01",
"name": "New Year's Day"
},
{
"date": "2026-01-19",
"name": "Martin Luther King Jr. Day"
},
{
"date": "2026-02-16",
"name": "Presidents' Day"
},
{
"date": "2026-05-25",
"name": "Memorial Day"
},
{
"date": "2026-07-03",
"name": "Independence Day (observed)"
},
{
"date": "2026-09-07",
"name": "Labor Day"
},
{
"date": "2026-10-12",
"name": "Columbus Day"
},
{
"date": "2026-11-11",
"name": "Veterans Day"
},
{
"date": "2026-11-26",
"name": "Thanksgiving Day"
},
{
"date": "2026-12-25",
"name": "Christmas Day"
}
]
},
"credits_used": 1,
"remaining_credits": 99
}実際のスケジューリングに対応
HRスケジューリング
複数の国にわたって休暇残高、給与計算サイクル、シフト表を計算する際に、祝日を自動的に除外します。
取引カレンダー
金融モデルやバックテストで非取引日をスキップします。決済やクリアリングのウィンドウに影響する銀行休業日を特定します。
物流のETA
発送元、輸送中、配送先の各国の祝日を自動的にスキップして、正確な配送見積もりを算出します。
n8n 自動化
n8n や Zapier のワークフローに組み込み、時間に敏感なアクションを制御します — 国の祝日にメールやレポートを送信しないようにできます。
HolidayAPI & Nager.Date の代替
当年データ、将来の年の計画、本番向けのSLA — 無料枠の年ロックも、コミュニティプロジェクトの信頼性リスクもありません。
HolidayAPI | Nager.Date | API Pick ✓ | |
|---|---|---|---|
| 無料枠 | 前年のみ | 無料（SLAなし） | 登録時に100クレジット |
| 当年データ | 有料プランのみ | ✓ | ✓ |
| 将来の年のデータ | 有料プランのみ | ✓（制限あり） | ✓ 最大+10年 |
| 履歴データ（1900年以降） | 有料プランのみ | 一部対応 | ✓ 1900年から |
| 本番向けSLA | 有料プランのみ | ✗ コミュニティプロジェクト | ✓ |
| 対応国数 | ~100 | ~110 | 100+ |
| 開始にクレジットカード不要 | ✗ | ✓ | ✓ |
| クレジット／リクエストの有効期限は？ | 年間プラン | N/A | 無期限 |
| AIエージェント／LLM対応 | 一部対応 | 一部対応 | ✓ ネイティブJSON |
HolidayAPI の無料枠の罠
HolidayAPIの無料プランは意図的に前のカレンダー年のみに制限されています。当年の祝日を調べたり、2027年の休暇スケジュールを前もって計画したりする必要がありますか？有料プランへのアップグレードが必須です。スケジューリングや自動化のユースケースでは、無料枠は初日から実質的に使い物になりません。
Nager.Date の信頼性リスク
Nager.Date はコミュニティが管理するオープンソースプロジェクトです — 無料で利用できますが、稼働率のSLAも、サポート契約も、継続提供の保証もありません。これを基盤に給与システムや物流パイプラインを構築したチームは、予期せぬダウンタイムや廃止に見舞われてきました。プロトタイピングには適していますが、本番には向きません。
レスポンスフィールド
| フィールド | 型 | 説明 |
|---|---|---|
| data.country | string | ISO 3166-1 alpha-2 国コード（大文字） |
| data.country_name | string | 英語の正式な国名 |
| data.year | integer | クエリしたカレンダー年 |
| data.total | integer | その年の祝日の数 |
| data.holidays | array | 日付順にソートされた祝日オブジェクトのリスト |
| data.holidays[].date | string | YYYY-MM-DD フォーマットの祝日の日付 |
| data.holidays[].name | string | 祝日の正式名称 |
| credits_used | integer | このリクエストで差し引かれたクレジット |
| remaining_credits | integer | アカウントに残っているクレジット |
レート制限
スロットリングはAPIキー単位、60秒のスライディングウィンドウです。上限に達すると、Retry-Afterヘッダー付きのクリーンな429が返されます。
120req/min
APIキー単位・エンドポイント単位。60秒のスライディングウィンドウ。
3concurrent
APIキーごとの同時進行リクエストの最大数。
X-RateLimit-Limit1分あたりに許可される最大リクエスト数X-RateLimit-Remaining現在のウィンドウで残っているリクエスト数X-RateLimit-Reset現在のウィンドウがリセットされるまでの秒数Retry-After再試行までの待機秒数（429の場合のみ）HTTP/1.1 429 Too Many Requests
Retry-After: 12
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 12
{
"error": "rate_limit_exceeded",
"message": "Rate limit exceeded: 120 requests/minute per API key. Retry after 12s.",
"retry_after": 12
}よくある質問
Q: どの国に対応していますか？
A: オープンソースの python-holidays（vacanza）ライブラリを介して100以上の国に対応しています。米国、英国、ドイツ、フランス、日本、中国、オーストラリア、カナダ、インド、ブラジル、そしてヨーロッパ、アジア、ラテンアメリカ、アフリカの大部分が含まれます。有効なISO 3166-1 alpha-2 コード（例 US、GB、DE）を使用してください。
Q: どれくらい過去と未来までクエリできますか？
A: 1900年から10年先の未来まで、任意の年をクエリできます。過去の祝日はその当時に有効だったルールに基づいて計算されるため、結果は今日のルールを過去に投影したものではなく、実際の歴史的な祝祭日を反映します。
Q: 地域／州の祝日は含まれますか？
A: このエンドポイントは国の祝日のみを返します。州、省、地域固有の祝祭日（例: 米国の州の祝日、ドイツの州（Länder）の祝日）はデフォルトのレスポンスには含まれません。地方自治体レベルの祝日データが必要な場合はお問い合わせください。
Q: AIエージェントはこれをツールとして利用できますか？
A: はい。このエンドポイントは2つのクエリパラメータ（country と year）を受け取り、構造化JSON配列を返します — OpenAI、Claude、LangChain、その他あらゆるエージェントフレームワークのファンクションツールとして簡単に定義できます。複数の国にわたって営業日について推論する必要があるスケジューリングエージェントに最適です。
Claude Code & AIエージェントで祝日を使う
公式のClaude Codeスキルをインストールすれば、AIコーディングエージェントの中から直接、100以上の国の祝日をクエリできます — 自然言語でソート済みの日付、正式名称、件数を取得。
AIエージェントに自然に尋ねる
対応プラットフォーム
APIpick 祝日API向けのClaude Codeスキル
100以上の国について、英語の正式名称と合計件数を添えて、日付順にソートされた祝日リストを返します。1900年から10年先までの年に対応。