GET
/coverGrabs an album cover image. Chuck in an artist and title, or just an ISRC if you have one. Images get upscaled to 1024×1024 so they actually look decent.
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 basically instant.
- 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. Stuff in brackets like "(Radio Edit)" gets stripped automatically. |
| isrc | string | optional | ISRC code. If you have got this, you do not need artist or title. |
Request
curl 'https://api.synkradio.co.uk/cover' \
-H 'User-Agent: [email protected]'Try it
GETTry it
Sends a real requesthttps://api.synkradio.co.uk/cover?artist=Daft%20Punk&title=Get%20Lucky&isrc=USQX91300809Response
Returns binary
image/jpeg. Pipe the response body directly to a file or stream.