API ドキュメント

MAGICAL SPECファンサイトの公開APIです。認証なしで利用でき、JSONでデータを取得できます。

概要

ベースURL	`https://www.magicalspec.jp/api/v1`
認証	不要（公開API）
レスポンス形式	JSON (UTF-8)
HTTPメソッド	GET のみ
レート制限	60 requests / 分 / IP
CORS	全オリジン許可

レスポンス形式

成功レスポンス

{
  "data": [ ... ],
  "meta": {
    "total": 100,
    "per_page": 20,
    "current_page": 1,
    "last_page": 5
  }
}

エラーレスポンス

{
  "error": {
    "code": "NOT_FOUND",
    "message": "リソースが見つかりません"
  }
}

ステータスコード

200	成功
404	リソースが見つかりません
422	バリデーションエラー（パラメータ不正）
429	レート制限超過
500	サーバエラー

GET /api/v1/events

イベント一覧を取得します（新しい順、ページネーション付き）。

クエリパラメータ

パラメータ	型	説明
`from`	YYYY-MM-DD	この日付以降のイベント
`to`	YYYY-MM-DD	この日付以前のイベント
`year`	YYYY	指定年のイベント
`month`	YYYY-MM	指定年月のイベント
`event_type`	string	oneman / festival / taiban / event / regular / release / tokutenkai / offkai / other
`venue_area`	string	地域（例: 福岡、東京、大阪）
`has_setlist`	boolean	true=セトリ有のみ / false=セトリ無のみ
`page`	integer	ページ番号（デフォルト: 1）
`per_page`	integer	1ページあたり件数（1〜100、デフォルト: 20）

使用例

# 2026年3月のイベント
https://www.magicalspec.jp/api/v1/events?from=2026-03-01&to=2026-03-31

# 2025年のワンマンライブ
https://www.magicalspec.jp/api/v1/events?year=2025&event_type=oneman

# 福岡で開催されたセトリ付きイベント
https://www.magicalspec.jp/api/v1/events?venue_area=福岡&has_setlist=true&per_page=50

レスポンス例

{
  "data": [
    {
      "id": 448,
      "title": "「令和8年度マジスペ学園入学式」東京公演",
      "slug": "8-tokyo-2026-04-21",
      "event_type": "oneman",
      "event_date": "2026-04-21",
      "venue": "Spotify O-nest",
      "venue_area": "東京",
      "description": "出演: ライブ 17:00〜 / チケット: 前方¥8,000...",
      "notes": "●開催日時\n2026年4月21日(月)\n...（TimeTree概要欄の全文）",
      "url": "https://www.magicalspec.jp/events/8-tokyo-2026-04-21",
      "setlist_count": 12
    }
  ],
  "meta": { ... }
}

descriptionは短い要約、notesはTimeTree概要欄の全文です（長文注意）。

GET /api/v1/events/upcoming

今日以降の直近イベントを取得します（古い順）。

クエリパラメータ

パラメータ	型	説明
`days`	integer	今日から何日先まで取得するか（1〜365、デフォルト: 60）
`limit`	integer	取得件数（1〜50、デフォルト: 20）

使用例

# 今後1週間のイベントを5件
https://www.magicalspec.jp/api/v1/events/upcoming?days=7&limit=5

GET /api/v1/events/{id}

イベントの詳細情報をセットリスト付きで取得します。

使用例

https://www.magicalspec.jp/api/v1/events/448

レスポンス例

{
  "data": {
    "id": 448,
    "title": "「令和8年度マジスペ学園入学式」東京公演",
    "event_date": "2026-04-21",
    "venue": "Spotify O-nest",
    "setlist_count": 12,
    "setlist": [
      {
        "position": 1,
        "title": "寸劇",
        "is_cover": true,
        "is_encore": false,
        "note": null,
        "song": null
      },
      {
        "position": 2,
        "title": "Chu Love♡",
        "is_cover": false,
        "is_encore": false,
        "note": null,
        "song": {
          "id": 3,
          "title": "Chu Love♡",
          "slug": "chu-love"
        }
      }
    ]
  }
}

利用上の注意

このAPIは非公式ファンサイトが提供するもので、MAGICAL SPEC・IQプロジェクト・Uniiique Entertainmentとは一切関係ありません。
取得したデータは商用利用しないでください。
レート制限を超えると 429 Too Many Requests が返ります。
データの正確性は保証されません。誤りを見つけた場合はフィードバックからお知らせください。
予告なく仕様変更・提供停止する場合があります。