API利用マニュアル

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

共通仕様

GETで取得します。
結果はすべてJSON形式で返します。文字コードはUTF-8です。
パラメータ名末尾に「[]」がつくリクエストはコンマ区切りで値の複数指定が可能です。
パラメータ名末尾に「[]」がつくレスポンスは配列で返ります。(結果が1つの場合でも配列になります。)
値が空のときにNULLを返す項目と空文字列を返す項目があります。

アクセス制限

短時間に大量のリクエストはUserAgent単位、IPアドレス単位でアクセス制限する場合があります。
大量のアクセスを行うアプリケーションの場合、独自のUserAgentを付加していただけると助かります。
MOR放送前後・単独ライブ直後は特に混み合いますので処理に時間がかかる場合や一時的なアクセス制限(サーバー側の503エラー)が行われる可能性があります。
単独ライブ中・早朝の時間帯は比較的処理リソースに余裕があります。

ライセンス

クリエイティブ・コモンズ・ライセンス
この 作品 は クリエイティブ・コモンズ 表示 - 非営利 4.0 国際 ライセンス の下に提供されています。

なお、このAPIの利用においてサイト維持のために掲載されるサイト内広告、アフィリエイトは営利には含まないものと解釈します。

URI

ベースのURIは「https://api.fujiwarahaji.me/v1/」です。
HTTPSでの通信を基本としていますが、HTTPでの通信も可能です。
HTTPで通信時もHTTPSのURIを返します。

/list 一覧・検索

曲一覧
リクエスト
必須 パラメータ 内容 初期
必須 type 出力モードを楽曲に設定 music
任意 limit 出力する上限数 自然数 無限
任意 music_type[] 楽曲の種類で絞り込み cg ml sc as joint cover 全種
任意 orderby 出力順序 title date rand date
任意 order 出力の正順・逆順 asc desc desc
任意 search キーワード検索 検索キーワード
https://api.fujiwarahaji.me/v1/list?type=music 全楽曲の一覧を表示
https://api.fujiwarahaji.me/v1/list?type=music&search=器&limit=1 「器」を含む楽曲を1曲表示する
レスポンス
配列で出力されます。
パラメータ親 パラメータ子 説明 出力値
name 曲名
type music
music_type 楽曲のタイプ cg ml sc as joint cover
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 全プロダクション
https://api.fujiwarahaji.me/v1/list?type=live&search=Funky Dancing 「Funky Dancing!」を含むライブを検索
https://api.fujiwarahaji.me/v1/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
kana アイドル名よみがな(type=idolの場合のみ)
cv 声優名(type=idolの場合のみ)
cvkana 声優名よみがな(type=idolの場合のみ)

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

アイドル名、ユニット名の部分一致での検索、その他のカテゴリでの検索が必要な場合はまず/listより検索を実行してAPIを実行してください。
ユニット名は表記ゆれなどがある場合がありますので、「unit_name」で完全一致を狙うのはあまりおすすめできません。

その他カテゴリ一覧
リクエスト
必須 パラメータ 内容 初期
いずれか1つが必須
id→idol_name→unit_nameの優先順で排他利用
id tax_id 自然数
idol_name アイドル名(完全一致) 名字と名前の間にスペースなし(例:藤原肇)
unit_name ユニット名(完全一致)
任意 limit 出力する上限数 自然数 無限
任意 music_type[] 楽曲の種類で絞り込み cg ml sc as joint cover 全種
任意 orderby 出力順序 name date random name
任意 order 出力の正順・逆順 asc desc desc
https://api.fujiwarahaji.me/v1/tax?id=1665 ID「1665」のカテゴリデータを取得
https://api.fujiwarahaji.me/v1/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
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
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/v1/music?id=3525 ID「3525」の楽曲を表示
https://api.fujiwarahaji.me/v1/music?id=2907&hide=cd-member,live-member 765プロ所属のアイドル一覧を表示
レスポンス
パラメータ親 パラメータ子 説明 出力値
name 曲名
type 出力している情報の種類 music
music_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型
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
cv 声優名
solo ソロバージョンかどうか(member型soloの場合のみ) TRUE or FALSE

更新情報

2020/08/25 HTTPについて追記
2020/08/22 初版

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

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