GET
/listenStreams full track audio on demand. Resolves via artist + title or ISRC. This route is not cached on my end. Every single request goes straight upstream. Do not spam it.
Rate limit
10 req/min
Caching
Not cached in the internal database. Every request goes upstream. Cloudflare edge might cache it briefly.
Notes
- Either isrc or both artist and title must be provided.
- Byte-range requests are supported for seeking.
- Not cached in the internal database. Cloudflare edge caching may still apply, but I do not store it. Do not spam it.
- Response is a full MP3 stream. You can pipe it straight into an audio element.
- Content-Length header is included so players can show duration.
Authentication
Send a
User-Agent header containing a contact email. See authentication.Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| artist | string | optional | Artist name. Needed if you are not passing an ISRC. |
| title | string | optional | Track title. Needed if you are not passing an ISRC. |
| isrc | string | optional | ISRC code. Quicker lookup than artist + title. |
Request
curl 'https://api.synkradio.co.uk/listen' \
-H 'User-Agent: [email protected]'Try it
GETTry it
Sends a real requesthttps://api.synkradio.co.uk/listen?artist=Daft%20Punk&title=Get%20Lucky&isrc=USQX91300809Response
Returns binary
audio/mpeg. Pipe the response body directly to a file or stream.