GET
/editorial/selectionThe editorially curated album selection for a genre. This is the hand-picked editors choice shelf rather than an algorithmic chart.
Rate limit
60 req/min
Caching
Cached 1 hour per genre.
Notes
- Selections change slowly, typically weekly.
- Not every genre has a published selection; those return 404.
Authentication
Send a
User-Agent header containing a contact email. See authentication.Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| genre | string | optional | Genre name or ID. Defaults to 0, meaning all genres. |
| limit | integer | optional | Albums to return, 1-100. Defaults to 25. |
Request
curl 'https://api.synkradio.co.uk/editorial/selection' \
-H 'User-Agent: [email protected]'Try it
GETTry it
Sends a real requesthttps://api.synkradio.co.uk/editorial/selection?genre=rock&limit=10Response
200 application/json
{
"genre": "Pop",
"genreId": 132,
"count": 2,
"albums": [
{
"id": 704129551,
"title": "Si Brutal",
"artist": "bad Bad Bird",
"artistId": 573278,
"cover": "/media/images/images/cover/f125cbd7f6d878aa7dc259b6f5ed6e40/1000x1000-000000-80-0-0.jpg",
"releaseDate": null,
"recordType": "album",
"explicit": false,
"genreId": 132
},
{
"id": 987691681,
"title": "Detour",
"artist": "Kim Petras",
"artistId": 4652821,
"cover": "/media/images/images/cover/75ab4e73cdde5116f2a14fea67bf050d/1000x1000-000000-80-0-0.jpg",
"releaseDate": null,
"recordType": "album",
"explicit": true,
"genreId": 132
}
]
}Response schema
| Field | Type | Example | Description |
|---|---|---|---|
| genre | string | "Pop" | |
| genreId | number | 132 | |
| count | number | 2 | |
| albums | array<object> | 2 items |