Skip to main content

REST API

REST API

The Songle Widget REST API returns the music structure (beat, chord, melody, chorus), song metadata, and search results as JSON / XML.

Overview​

  • All requests are GET and require no authentication.
  • Responses include the CORS header Access-Control-Allow-Origin: *, so they can be called directly from the browser.
  • The base URL is https://widget.songle.jp.
  • The response format is selected by the path extension: append .json (default) or .xml (e.g. /api/v1/song.json, /api/v1/song.xml).
  • Response body keys are camelCase by default. Specify syntax=snakecase for snake_case keys.
  • On error the body is always {}; the case is distinguished by the HTTP status code (400 missing required parameter / 404 not registered or not recognized / 502 upstream failure / 504 upstream timeout).

Example request​

GET https://widget.songle.jp/api/v1/song.json?url=www.youtube.com/watch?v=PqJNc9KVIZE

See each page in the left sidebar for endpoint details (parameters, responses, and real response examples).