Holidays JP API

日本の国民の祝日の一覧を、JSON形式もしくはCSV形式で返すAPIです。

データは Google が用意している Googleカレンダーの情報から自動で生成しています。

去年・今年・来年のデータが取得可能です。

祝日一覧API (date)

URL

https://holidays-jp.github.io/api/v1/date.json

返却例

{
  "2017-01-01": "元日",
  "2017-01-02": "元日 振替休日",
  "2017-01-09": "成人の日"
}

日付をキーに、祝日名が入ったオブジェクトを返します。

CSV形式

URL末尾の拡張子部分を csv にすることで、CSV形式で返します(全API共通)。

https://holidays-jp.github.io/api/v1/date.csv

返却例

2017-01-01,元日
2017-01-02,"元日 振替休日"
2017-01-09,成人の日

祝日一覧API (datetime)

URL

https://holidays-jp.github.io/api/v1/datetime.json

返却例

{
  "1420038000": "元日",
  "1420988400": "成人の日",
  "1423580400": "建国記念の日"
}

unixtimeをキーに、祝日名が入ったオブジェクトを返します。

年別API (date)

URL

https://holidays-jp.github.io/api/v1/2017/date.json

上記URLの 2017の部分に、年号を4桁で指定します。

指定された年のデータだけを返します。返却形式は基本API(date)と同じです。

年別API (datetime)

URL

https://holidays-jp.github.io/api/v1/2017/datetime.json

上記URLの 2017の部分に、年号を4桁で指定します。

指定された年のデータだけを返します。返却形式は基本API(datetime)と同じです。


License

MIT

紹介ブログ