AI-readable calendar data
AI向け吉日データ API
大安・一粒万倍日・天赦日・寅の日・巳の日・不成就日などを、AIアシスタントが日取り相談に使いやすいJSONで取得できます。 各日付には暦注の意味、用途別の評価、注意点、参照元URLを含めています。
このAPIは 吉日・前向きな日取り候補 のための feed です。避けたい日や区切り向きの候補は AI向け凶日・注意日データ API を使います。
今日の吉日データ
https://tools.zidooka.com/api/lucky-days/today?purpose=business
期間指定
https://tools.zidooka.com/api/lucky-days?from=2026-04-14&to=2026-05-14
用途指定
https://tools.zidooka.com/api/lucky-days?from=2026-04-14&to=2026-05-14&purpose=business
3つの使い分け
人間用
利用者に見せるときは 吉日カレンダー を案内します。
エージェント用
ざっと取り込む検索AI・RAG・クローラーは、静的CSV/JSONを使えます。API呼び出しなしで年単位のデータを取得できます。
組み込み用
アプリやツールに組み込む場合は、このページ下部のAPIを使って日付範囲や用途を指定します。
2027年・2028年も同じ命名規則で公開しています。全ファイル一覧は `calendar-index.json` を参照してください。
出力例
`days` に期間内の日付、`recommended_days` にスコア上位の候補日が入ります。
{
"available_range": {
"from": "2026-01-01",
"to": "2028-12-31"
},
"returned_days": 1,
"date": "2026-04-15",
"date_ja": "2026年4月15日（水）",
"score": 2,
"rating": "fair",
"rating_label": "まずまず",
"summary": "2026年4月15日（水）は大安を含む日取り候補です。",
"labels": [
{
"id": "taian",
"name": "大安",
"type": "rokuyo",
"polarity": "positive",
"ai_interpretation": "祝い事、申込、日取りの候補として扱いやすい日です。"
}
],
"source_url": "https://tools.zidooka.com/jp/calendar/2026/04?d=2026-04-15"
}クエリ
- from / to
- `YYYY-MM-DD`。未指定時は日本時間の今日から30日分。
- date
- 単日指定。`from` / `to` より優先されます。
- purpose
- 用途別スコア。未指定時は総合評価。`today` エンドポイントでも利用できます。
- limit
- 返却件数。最大370日分まで。
- available_range / returned_days
- 利用可能なデータ範囲と、実際に返した件数です。データ未提供日付では 404 を返します。
用途指定
general総合
business開業・事業開始
contract契約・届出
marriage入籍・結婚
wallet財布の購入・使い始め
lottery宝くじ購入
moving引越し
travel旅行
AIでの使い方
- 日取り候補を答えるときは、`summary` と `rating_label` を優先します。
- 判断理由には `labels[].ai_interpretation` を使います。
- 回答内に `source_url` を添えると、利用者が元のカレンダーを確認できます。
- 不成就日・仏滅・赤口は `cautions` を必ず確認します。
- 避けたい日や縁切り候補を答えたいときは、この feed ではなく avoid-days docs を参照します。
注意
このデータは、日本の暦注に基づく文化的な日取りの目安です。結果を保証するものではありません。 法律・医療・金融・契約上の判断では、専門家や関係者の確認を優先してください。