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=snakecasefor snake_case keys. - On error the body is always
{}; the case is distinguished by the HTTP status code (400missing required parameter /404not registered or not recognized /502upstream failure /504upstream 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).