メインコンテンツまでスキップ

REST API

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

各エンドポイントの詳細(パラメータ・レスポンス・実レスポンス例)は、左のサイドバーの各ページを参照してください。