API利用マニュアル(v2)

サイト内で利用しているデータを整形して開発者向けに提供しています。

共通仕様

GETで取得します。
結果はすべてJSON形式で返します。文字コードはUTF-8です。
パラメータ名末尾に「[]」がつくリクエストはコンマ区切りで値の複数指定が可能です。
パラメータ名末尾に「[]」がつくレスポンスは配列で返ります。(結果が1つの場合でも配列になります。)
値が空のときにNULLを返す項目と空文字列を返す項目があります。必要に応じて変換をお願いします。
保管されているデータをあまり変換せず出力しているため不思議な仕様になっていますが、ご了承ください。

URI

ベースのURIは「https://api.fujiwarahaji.me/v2.1/」です。
HTTPSでの通信を推奨していますが、HTTPでの通信も可能です。
HTTPで通信時もHTTPSのURIを返します。
HTTP利用時のセキュリティ対策は開発者さまのほうでよろしくお願いします。

/list 一覧・検索

曲一覧
リクエスト
必須 パラメータ 内容 初期
必須 type 出力モードを楽曲に設定 music
任意 limit 出力する上限数 自然数 無限
任意 music_type[] 楽曲の種類で絞り込み cg ml sc as joint cover remix sidem 全種
任意 orderby 出力順序 title date rand date
任意 order 出力の正順・逆順 asc desc desc
任意 search キーワード検索 検索キーワード
https://api.fujiwarahaji.me/v2.1/list?type=music 全楽曲の一覧を表示
https://api.fujiwarahaji.me/v2.1/list?type=music&search=器&limit=1 「器」を含む楽曲を1曲表示する
レスポンス
配列で出力されます。
パラメータ親 パラメータ子 説明 出力値
name 曲名
type music
music_type 楽曲のタイプ cg ml sc as joint cover remix sidem
song_id 楽曲ID(内部管理ID) 数値
link 楽曲ページURL
api 曲情報のJSON URI
分類一覧
リクエスト
必須 パラメータ 内容 初期
必須 type 一覧表示する分類 live idol lyrics composer arrange disc cv
任意 orderby 出力順序(type=live以外で有効。liveは日付順固定。カバーライブは最後にまとまります。) name count name
任意 order 出力の正順・逆順 asc desc desc
任意 search キーワード検索 検索キーワード
分類名とyyyy-mm-dd形式以外の検索はできません。
title
任意 production[] アイドルの所属プロダクション(type=idolでのみ有効。) cg 765 sc 315 全プロダクション
https://api.fujiwarahaji.me/v2.1/list?type=live&search=Funky Dancing 「Funky Dancing!」を含むライブを検索
https://api.fujiwarahaji.me/v2.1/list?type=idol&production=765 765プロ所属のアイドル一覧を表示
レスポンス
配列で出力されます。
パラメータ親 パラメータ子 説明 出力値
name 曲名
type 出力しているカテゴリ名 live idol lyrics composer arrange disc cv
tax_id カテゴリID(内部管理ID) 数値
link ふじわらはじめ内カテゴリページURL
api カテゴリのJSON URI
date ライブの日時(type=liveの場合のみ) yyyy-mm-dd
production アイドルの所属プロダクション(type=idolの場合のみ) cg 765 sc 315
kana アイドル名よみがな(type=idolの場合のみ)
cv 声優名(type=idolの場合のみ)
cvkana 声優名よみがな(type=idolの場合のみ)

/tax カテゴリ内一覧・カテゴリ情報

アイドル名、ユニット名の部分一致での検索、その他のカテゴリでの検索が必要な場合はまず/listより検索を実行してAPIを実行してください。
ユニット名は表記ゆれなどがある場合がありますので、「unit_name」で完全一致を狙うのはあまりおすすめできません。
ライブの日付も同様にスラッグの完全一致が必要です。同じ日にライブが複数回ある場合などデータが引き出せない場合があります。

その他カテゴリ一覧
リクエスト
必須 パラメータ 内容 初期
いずれか1つが必須
id→idol_name→unit_name→live_dateの優先順で排他利用
id tax_id 自然数
idol_name アイドル名(完全一致) 名字と名前の間にスペースなし(例:藤原肇)
unit_name ユニット名(完全一致)
live_date ライブの日付 同じ日に複数回ライブがあるなど重複がない限り「yyyy-mm-dd」
スラッグ(ライブページURLの「https://fujiwarahaji.me/live/」以降の部分)を利用
任意 limit 出力する上限数 自然数 無限
任意 music_type[] 楽曲の種類で絞り込み cg ml sc as joint cover remix sidem 全種
任意 orderby 出力順序 name date random name
任意 order 出力の正順・逆順 asc desc desc
https://api.fujiwarahaji.me/v2.1/tax?id=1665 ID「1665」のカテゴリデータを取得
https://api.fujiwarahaji.me/v2.1/tax?idol_name=春日未来&music_type=joint,cg アイドル名「春日未来」の参加する合同楽曲、シンデレラ曲を取得
レスポンス
パラメータ親 パラメータ子 説明 出力されるカテゴリ 出力値
name カテゴリ名(アイドル名、ライブ名) all
type 出力しているカテゴリ名
tax_id カテゴリID(内部管理ID) 数値
link ふじわらはじめ内カテゴリページURL
api カテゴリのJSON URI
kana よみがな idol unit
cv 声優名 idol
cvkana 声優名よみがな idol
production アイドルの所属プロダクション idol cg 765 sc 315
date ライブの日時 live yyyy-mm-dd
place ライブ会場 live
member[] 参加メンバー、ユニットメンバー live unit member型
setlist セットリストの有無 live TRUE or FALSE
lyrics
composer
arrange
同じ名義で作業した楽曲一覧を表示するためのカテゴリ情報を出力します。
tax_id 同じ名義のカテゴリID(内部管理ID) lyrics composer arrange 数値
link 同じ名義のふじわらはじめ内カテゴリページURL lyrics composer arrange
api 同じ名義のカテゴリのJSON URI lyrics composer arrange
music[] 楽曲情報の出力場所です。
name 曲名 all
type music
music_type 楽曲のタイプ cg ml sc as joint cover remix sidem
song_id 楽曲ID(内部管理ID) 数値
link 楽曲ページURL
api 曲情報のJSON URI
song_text セットリスト補足情報、MCなど live
unit[] 参加ユニット disc live unit型
member[] 参加メンバー member型solo(disc)
member型(live)
member_text メンバー情報補足情報(ユニット名など) live
solo ソロ音源が収録されたCDがあるか idol TRUE or FALSE

/music 楽曲情報

HTTPヘッダーの「last-modified」にデータ最終更新日を出力します。
ただし、内部処理でカテゴリーに紐付いているデータ(ライブの会場・日付・歌唱メンバー、アイドルのCV情報など)の更新時間は反映されません。

その他カテゴリ一覧
リクエスト
必須 パラメータ 内容 初期
必須 id データを表示する楽曲ID 自然数
任意 hide[] 出力を省く(高速化) cd-member live-member 無効(全情報出力)
https://api.fujiwarahaji.me/v2.1/music?id=3525 ID「3525」の楽曲を表示
https://api.fujiwarahaji.me/v2.1/music?id=2907&hide=cd-member,live-member CDメンバー、ライブメンバーを省いて表示
レスポンス
パラメータ親 パラメータ子 説明 出力値
name 曲名
type 出力している情報の種類 music
song_id 楽曲ID(内部管理ID)
link ふじわらはじめ内楽曲URL
api 楽曲のJSON URI
remix[]
orignal[]
original[]
リミックスの場合:「remix[]」として原曲の情報を出力
楽曲の場合:「orignal[]」としてリミックスバージョンの一覧を出力
「orignal」は誤字のためv2.1以降では「original」になります
name 曲名
type music
song_id 楽曲ID(内部管理ID)
link 楽曲ページURL
api 曲情報のJSON URI
lyrics[] composer[] arrange[] 作詞・作曲・編曲(リアレンジ楽曲などのアレンジ者含む)情報
ただし、リミックスでは作詞・作曲情報は出力されません(項目自体が消えます)
name 名前、ユニット名など
type 出力しているカテゴリ名 lyrics composer arrange
tax_id カテゴリID(内部管理ID)
link ふじわらはじめ内カテゴリページURL
api カテゴリのJSON URI
lyrics_url 歌詞サイトURL
(リミックスでは出力されません。必要な場合は原曲から参照してください。)
URL
member[] CD、配信、ゲーム(CGSS,MLTD)参加メンバー member型
digital デジタル配信の有無 TRUE or FALSE
disc[] CD情報
name 名前、ユニット名など
type 出力しているカテゴリ名 disc
tax_id カテゴリID(内部管理ID)
link ふじわらはじめ内カテゴリページURL
api カテゴリのJSON URI
unit 参加ユニット unit型
member 参加メンバー member型solo
live[] 披露されたライブの情報
name 名前、ユニット名など
type 出力しているカテゴリ名 live
tax_id カテゴリID(内部管理ID)
link ふじわらはじめ内カテゴリページURL
api カテゴリのJSON URI
date ライブの日時 yyyy-mm-dd
place ライブ会場
unit 歌唱ユニット unit型
member 歌唱メンバー member型

レスポンス型

よく使うunit型、member型のレスポンスのかたちは以下の通りです。
unit型
パラメータ 説明 出力値
name ユニット名
type 出力しているカテゴリ名 unit
tax_id カテゴリID(内部管理ID) 数値
link ふじわらはじめ内カテゴリページURL
api カテゴリのJSON URI
member[] ユニットメンバー member型
member型
パラメータ 説明 出力値
name アイドル名
type 出力しているカテゴリ名 idol
tax_id カテゴリID(内部管理ID) 数値
link ふじわらはじめ内カテゴリページURL
api カテゴリのJSON URI
production アイドルの所属プロダクション(type=idolでのみ有効) cg 765 sc 315
cv 声優名
solo ソロバージョンかどうか(member型soloの場合のみ) TRUE or FALSE

v1からの主な変更点

  • リミックス(remix)とSideM(sidem・315)に対応しました
  • 楽曲情報のレスポンスでのみ使われていた「music_id」を「song_id」に統一しました
  • デジタル配信の有無データを返すようになりました

v2とv2.1のちがい

レスポンスの「orignal」を「original」に修正したのみです。
修正後の「original」にプログラムを修正してからお使いください。

更新情報

2022/11/08 「original」の誤字修正のためv2.1へバージョンアップ
2022/09/15 リクエスト「live_date」を追加
2022/04/09 v2提供開始

Twitter「#ふじわらはじめAPI」 でも更新情報・メンテナンス情報などをお知らせしています。

なにかありましたらTwitterメールフォームマシュマロなどから連絡ください。