GET
/album/infoReturns full metadata for an album. Pass an album ID or a search query. Gets you the release info, label, genres, contributors, and a full tracklist summary in one go.
Rate limit
60 req/min
Caching
Cached in the internal database per album for 1 hour.
Authentication
Send a
User-Agent header containing a contact email. See authentication.Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| id | string | optional | Upstream album ID. Faster than a search if you have got it. |
| query | string | optional | Album name to search for. Include the artist name for better results, e.g. random access memories daft punk. |
Request
curl 'https://api.synkradio.co.uk/album/info' \
-H 'User-Agent: [email protected]'Try it
GETTry it
Sends a real requesthttps://api.synkradio.co.uk/album/info?query=daft%20punkResponse
200 application/json
{
"id": 11195631,
"title": "Random Access Memories",
"artist": {
"id": 27,
"name": "Daft Punk"
},
"cover": "https://api.synkradio.co.uk/cover?artist=Daft+Punk&title=Random+Access+Memories",
"releaseDate": "2013-05-17",
"recordType": "album",
"trackCount": 13,
"duration": 4147,
"label": "Columbia",
"upc": "88883716861",
"explicit": false,
"genres": [
"Dance",
"Electro"
],
"contributors": [
{
"id": 27,
"name": "Daft Punk",
"role": "Main"
}
],
"tracks": [
{
"id": 67238734,
"title": "Give Life Back to Music",
"durationMs": 274000,
"explicit": false,
"trackNumber": 1
},
{
"id": 116706671,
"title": "Get Lucky",
"durationMs": 369000,
"explicit": false,
"trackNumber": 8
}
]
}Response schema
| Field | Type | Example | Description |
|---|---|---|---|
| id | number | 11195631 | Provider identifier for the resource. |
| title | string | "Random Access Memories" | Display title of the resource. |
| artist | object | 2 fields | Primary artist, either as a string or nested object. |
| cover | string | "https://api.synkradio.co.uk/cover?artist…" | Public URL of the cover art. |
| releaseDate | string | "2013-05-17" | Release date in YYYY-MM-DD form. |
| recordType | string | "album" | One of album, single, ep, compilation. |
| trackCount | number | 13 | Number of tracks on the release. |
| duration | number | 4147 | Duration in seconds. |
| label | string | "Columbia" | Record label name. |
| upc | string | "88883716861" | Universal Product Code. |
| explicit | boolean | false | True if the track is marked explicit. |
| genres | array<string> | 2 items | Array of genre tags. |
| contributors | array<object> | 1 item | List of contributing artists with roles. |
| tracks | array<object> | 2 items | Tracklist for the release. |