GET
/coverReturns an album cover image. Pass an artist and title, or an ISRC. Images are upscaled to 1024×1024.
Rate limit
60 req/min
Caching
Cached in the internal database indefinitely. First request is slow-ish, everything after is instant.
Notes
- Either isrc or both artist and title must be provided.
- Results are cached in the internal database, so repeated requests for the same track are served almost immediately.
- Returns a 404 if no cover art can be found for the given track.
- Images are always JPEG regardless of the original format.
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. If there are multiple artists separated by commas, it just uses the first one. |
| title | string | optional | Track title. Needed if you are not passing an ISRC. Text in brackets, such as "(Radio Edit)", is removed automatically. |
| isrc | string | optional | ISRC code. If you have got this, you do not need artist or title. |
Request
curl 'https://api.synkradio.uk/cover' \
-H 'User-Agent: you@example.com'Try it
GETTry it
Sends a real requesthttps://api.synkradio.uk/cover?artist=Daft%20Punk&title=Get%20Lucky&isrc=USQX91300809Response
Returns binary
image/jpeg. Pipe the response body directly to a file or stream.