keep-check

Holiday API

祝日情報を取得するAPI

API説明

API使い方

情報引用元

お知らせ

注意事項

運営情報

API概要

Holiday APIは、日本の祝日情報をJSON形式で提供するAPIです。

ベースURL

https://holiday.keep-check.net

ベースURL

https://holiday.keep-check.net

エンドポイント一覧

GET /jp/now

説明: 現在年の祝日データを取得します

リクエスト例

curl -X GET "https://holiday.keep-check.net/jp/now"

レスポンス例

200 OK

                        {
                        "mode": "now",
                        "year": 2024,
                        "items": [
                        {
                        "year": 2024,
                        "date_text": "1月1日",
                        "date": "2024-01-01",
                        "name": "元日"
                        }
                        ]
                        }
                    

GET /jp/now/all

説明: 現在年以降の全ての祝日データを取得します

リクエスト例

curl -X GET "https://holiday.keep-check.net/jp/now/all"

レスポンス例

200 OK

                        {
                        "mode": "now/jp/all",
                        "from_year": 2024,
                        "items": [
                        {
                        "year": 2024,
                        "date_text": "1月1日",
                        "date": "2024-01-01",
                        "name": "元日"
                        }
                        ]
                        }
                    

GET /jp/all

説明: 2025年以降の全ての祝日データを取得します

リクエスト例

curl -X GET "https://holiday.keep-check.net/jp/all"

レスポンス例

200 OK

                        {
                        "mode": "all",
                        "items": [
                        {
                        "year": 2024,
                        "date_text": "1月1日",
                        "date": "2024-01-01",
                        "name": "元日"
                        },
                        {
                        "year": 2024,
                        "date_text": "1月8日",
                        "date": "2024-01-08",
                        "name": "成人の日"
                        }
                        ]
                        }
                    

エラーレスポンス

404 Not Found

                {
                "message": "Not found: GET /invalid-path"
                }
            

405 Method Not Allowed

                {
                "message": "Method Not Allowed"
                }
            

引用元

日本祝日情報 : 内閣府国民の祝日について

内閣府の情報公開ページに、祝日についても記されています。
https://www8.cao.go.jp/chosei/shukujitsu/gaiyou.html

お知らせ

2025年12月: Holiday API 初回リリース

公開を開始しました。

リリースノート

v1.0.0 (2025-12-25)

初回リリース
基本的な祝日取得エンドポイントを実装
全件取得、年別取得、期間指定取得に対応

注意事項

利用制限

現在、リクエスト数の制限は設けていませんが、過度なアクセスはお控えください

データについて

本APIは日本の祝日を、公的発表に基づき算出・提供します
最新の発表に合わせて更新しますが、正確性の保証はいたしません
利用者の責任でご利用ください

プライバシーとアクセス解析

本サイトではGoogle Analyticsを使用してアクセス状況を分析しています
収集されたデータは匿名化され、サービス改善の目的でのみ使用されます
詳細はGoogleのプライバシーポリシーをご確認ください

クレジット

ファビコンは Freepik による Flaticon の素材を使用しています

重要: このAPIは予告なく仕様が変更される可能性があります。利用者の責任でご利用ください。

運営情報

以下ブログの管理人が運営しています。
脱サラエンジニアの技術メモブログ- しすろぐ -