GET
/search/albumsSearches for albums. Handy if you are building anything that needs to browse by release rather than by track. Good for a discography view, a "find the album" feature, that sort of thing.
Rate limit
60 req/min
Caching
Cached per query in the internal database for 30 minutes.
Authentication
Send a
User-Agent header containing a contact email. See authentication.Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| query | string | required | Album name, artist, or both. e.g. random access memories daft punk. |
| limit | integer | optional | How many results to return. Between 1 and 50. Defaults to 20. |
Request
curl 'https://api.synkradio.co.uk/search/albums?query=around%20the%20world' \
-H 'User-Agent: [email protected]'Try it
GETTry it
Sends a real requesthttps://api.synkradio.co.uk/search/albums?query=daft%20punkResponse
200 application/json
[
{
"id": 11195631,
"title": "Random Access Memories",
"artist": "Daft Punk",
"artistId": 27,
"cover": "https://api.synkradio.co.uk/cover?artist=Daft+Punk&title=Random+Access+Memories",
"releaseDate": "2013-05-17",
"trackCount": 13,
"recordType": "album",
"explicit": false
},
{
"id": 302127,
"title": "Homework",
"artist": "Daft Punk",
"artistId": 27,
"cover": "https://api.synkradio.co.uk/cover?artist=Daft+Punk&title=Homework",
"releaseDate": "1997-01-22",
"trackCount": 16,
"recordType": "album",
"explicit": false
}
]