REST API
Songle Widget の REST API は、楽曲の音楽地図(拍・和音・メロディ・サビ)や楽曲メタデータ・検索結果を JSON / XML で返します。
概要
- すべて GET リクエストで、認証は不要です。
- レスポンスには CORS ヘッダ
Access-Control-Allow-Origin: *が付与され、ブラウザから直接呼び出せます。 - ベース URL は
https://widget.songle.jpです。 - レスポンス形式はパスの拡張子で選択します。
.json(既定)または.xmlを末尾に付けます(例:/api/v1/song.json、/api/v1/song.xml)。 - レスポンス body のキー命名は既定で camelCase です。
syntax=snakecaseを指定すると snake_case になります。 - エラー時の body は一律
{}で、HTTP ステータスコードで区別します(400必須パラメータ欠如 /404未登録・未認識 /502上流障害 /504上流タイムアウト)。
リクエスト例
GET https://widget.songle.jp/api/v1/song.json?url=www.youtube.com/watch?v=PqJNc9KVIZE
各エンドポイントの詳細(パラメータ・レスポンス・実レスポンス例)は、左のサイドバーの各ページを参照してください。