GET
/editorial/chartsThe combined editorial chart for a genre: top tracks, albums, artists and playlists in a single response. Handy for building a genre landing page in one call.
Rate limit
60 req/min
Caching
Cached 1 hour per genre.
Notes
- All four sections are returned together; some may be empty for narrower genres.
- Tracks include position, previewUrl and rank.
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 | Items per section, 1-50. Defaults to 10. |
Request
curl 'https://api.synkradio.co.uk/editorial/charts' \
-H 'User-Agent: [email protected]'Try it
GETTry it
Sends a real requesthttps://api.synkradio.co.uk/editorial/charts?genre=dance&limit=5Response
200 application/json
{
"genre": "Pop",
"genreId": 132,
"tracks": [
{
"id": 3602074142,
"name": "Choosin' Texas",
"artist": "Ella Langley",
"artistId": 14867123,
"album": "Choosin' Texas",
"albumId": 837881302,
"durationMs": 232000,
"explicit": false,
"isrc": null,
"rank": 978085,
"previewUrl": "https://cdnt-preview.dzcdn.net/api/1/1/5/b/5/0/5b539e49bdb2bbf9dd4bc00361ed7ca9.mp3?hdnea=exp=1789426811~acl=/api/1/1/5/b/5/0/5b539e49bdb2bbf9dd4bc00361ed7ca9.mp3*~data=user_id=0,application_id=42~hmac=badff5fd840afdaa14ba156051b0bb3a331d2a5db071a3651e28aed05fda5a7e",
"cover": "https://api.synkradio.co.uk/cover?artist=Ella%20Langley&title=Choosin'%20Texas",
"position": 1
},
"..."
],
"albums": [
{
"id": 1048236912,
"title": "Long Way Home",
"artist": "STELLA LEFTY",
"artistId": 181157207,
"cover": "/media/images/images/cover/8bffa30994d72ecb0f7f009b99c168fd/1000x1000-000000-80-0-0.jpg",
"releaseDate": null,
"recordType": "album",
"explicit": false
},
"..."
],
"artists": [
{
"id": 12246,
"name": "Taylor Swift",
"image": "/media/images/images/artist/e528e270424103b527f8a27ac625563b/1000x1000-000000-80-0-0.jpg",
"position": 1
},
"..."
],
"playlists": [
{
"id": 867825522,
"title": "80s Hits",
"cover": "/media/images/images/playlist/9103f288c270025230263354f24bfd0d/1000x1000-000000-80-0-0.jpg",
"trackCount": 100,
"creator": "Laeti - upstream Pop Editor",
"public": true
},
"..."
]
}Response schema
| Field | Type | Example | Description |
|---|---|---|---|
| genre | string | "Pop" | |
| genreId | number | 132 | |
| tracks | array<object> | 2 items | Tracklist for the release. |
| albums | array<object> | 2 items | |
| artists | array<object> | 2 items | |
| playlists | array<object> | 2 items |