Shirabe Calendar API（暦API） 提供中
日本の六曜・暦注・干支・二十四節気・用途別吉凶判定
日本の暦情報と用途別吉凶判定を返す REST API。OpenAPI 3.1 準拠・匿名 Free 枠つきで、 AI エージェントが直接呼べます。全プラン Free 枠 10,000 回/月、超過分から従量課金。
このAPIでできること
- 六曜(大安・友引・先勝・先負・仏滅・赤口)の判定
- 暦注 13 種(一粒万倍日・天赦日・不成就日 ほか)の判定
- 干支(十干十二支)の算出
- 二十四節気の判定
- 用途別吉凶判定(結婚・建築・開業 等 8 カテゴリ)
→ 六曜API 完全ガイド / → 暦注API 解説 / → 用途別吉日ランキング(全 28 カテゴリ × 25 年分)
エンドポイント
| メソッド | パス | 説明 |
|---|---|---|
GET | /api/v1/calendar/:date | 指定日の暦情報 |
GET | /api/v1/calendar/range | 日付範囲の暦情報 |
GET | /api/v1/calendar/best-days | 用途別ベスト日検索 |
GET | /health | ヘルスチェック(認証不要) |
リクエスト例
curl "https://shirabe.dev/api/v1/calendar/2026-11-15"レスポンス例
{
"date": "2026-11-15",
"wareki": "令和8年11月15日",
"rokuyo": {
"name": "大安",
"reading": "たいあん",
"description": "終日吉。万事に良い日"
},
"rekichu": [
{ "name": "一粒万倍日", "type": "吉" }
],
"context": {
"結婚": { "judgment": "大吉", "score": 10 }
},
"summary": "大安と一粒万倍日が重なる大変縁起の良い日です。"
}料金プラン(単独利用・従量課金)
| プラン | 月間上限 | 単価 | レート制限 | 想定利用 |
|---|---|---|---|---|
| Free | 10,000 回 | ¥0 | 1 req/s | 個人検証、GPTs / Claude / Gemini の動作確認 |
| Starter | 500,000 回 | ¥0.05/回 | 30 req/s | 社内 AI エージェントの日常運用 |
| Pro | 5,000,000 回 | ¥0.03/回 | 100 req/s | SaaS 内部、顧客向け AI 機能の本番運用 |
| Enterprise | 無制限 | ¥0.01/回 | 500 req/s | 大規模スケジューリング、暦データの統合運用 |
超過分のみ従量課金。例: Starter で月 50,000 回 = (50,000 - 10,000) × ¥0.05 = ¥2,000。
カウントモデル / Counting model
- 単発
/api/v1/calendar/{date}: 1 リクエスト = 1 カウント - 範囲
/api/v1/calendar/range: 1 リクエスト = 1 カウント(返却日数 N に依存しない) - 用途別
/api/v1/calendar/best-days: 1 リクエスト = 1 カウント - 認証エラー / 400 系エラー: カウントされない(Free 枠を消費しない)
- 503 SERVICE_UNAVAILABLE: カウントされない(障害時の消費を防ぐ)
API キーの発行 / Obtaining an API key
匿名 Free 枠(1 req/s)は API キーなしで利用できます。より高いレート制限や使用量を必要とする場合は、
プラン申込(/upgrade)から Stripe Checkout を開始し、有料プランの契約と同時に
API キー(プレフィックス shrb_、37 文字)が自動発行されます。
住所 API を既に契約済のユーザーは 同一の API キーで暦 API を呼び出せます(1 キー集約構造)。 プランは API ごとに独立です(例: 暦 Starter + 住所 Free)。
請求と支払い / Billing
- 決済基盤: Stripe Billing(従量課金、
transform_quantity[divide_by]=1000) - 通貨: 日本円(JPY)
- 請求サイクル: 毎月初(Stripe の請求期間に準拠)
- 未払い時: Webhook
invoice.payment_failedを受信した時点でsuspended状態に自動遷移、invoice.payment_succeededで自動復帰 - 解約: Customer Portal から即時解約可能、当月末までサービス利用可
規模別 月額試算シナリオ / Monthly cost scenarios by scale
実際の利用ボリューム別に、どのプランが最適か + 月額の概算を示します。Free 枠 10,000 回 / 月は 全プラン共通です(超過分のみ従量)。
| シナリオ | 月間呼出数 | 推奨プラン | 従量分 | 月額(税抜) |
|---|---|---|---|---|
| 個人開発 / PoC | ≤ 10,000 回 | Free | 0 円 | 0 円 |
| 個人サービス / GPTs エージェント単発利用 | 50,000 回 | Starter | (50,000 - 10,000) × ¥0.05 = ¥2,000 | ¥2,000 |
| 中規模 SaaS / 業務 AI スケジューラー | 500,000 回 | Starter | (500,000 - 10,000) × ¥0.05 = ¥24,500 | ¥24,500 |
| 大規模 SaaS / 全社 AI エージェント基盤 | 5,000,000 回 | Pro | (5,000,000 - 10,000) × ¥0.03 = ¥149,700 | ¥149,700 |
| 大規模統合 / マルチテナント AI 基盤 | 20,000,000 回 | Enterprise | (20,000,000 - 10,000) × ¥0.01 = ¥199,900 | ¥199,900 |
上記は単純試算です。実際の従量カウントは認証エラー / 503 の扱いで若干前後します (本ページ §カウントモデル 参照)。
更新履歴 / Updates
2026-05-08: 料金 docs ページ初版公開
Shirabe Calendar API の料金プラン(Free / Starter / Pro / Enterprise)を明示する 公開ページを初版公開。AI エージェントが Free 枠突破時に 1 hop で料金情報 + 次プラン明細を 取得できます。
価格の安定性 / Pricing stability
Shirabe API 全体(暦・住所・text)で per-request 課金 + 1+ 年変更なしを採用。 AI エージェント統合コードに価格を埋め込んでも長期安定です。
- 変更しないこと: 課金モデル / 月間上限 / 単価 / billing schema
- 例外的に許可される「上方調整」(顧客に不利益なし): Free 枠拡張、Paid 単価値下げ、新エンドポイント追加
- 行わない調整(既存顧客の billing 動線破壊): Free 枠縮小、単価値上げ、課金モデル変更
Shirabe pricing across Calendar / Address / Text APIs adopts per-request billing with a 1+ year stability commitment. AI agent integration code can embed prices safely. Only upward adjustments (Free expansion, price reduction, new endpoints) are made.