GET
/genre/chartThe real per-genre chart. Pass a genre name or an id from /editorial/genres and get the actual chart for it, for tracks, albums, artists or playlists.
Rate limit
60 req/min
Caching
Cached 30 minutes per genre and type.
Notes
- A 400 or 404 response includes availableGenres, so you can discover valid values without a second call.
- Tracks carry a position field reflecting their chart placement, plus previewUrl and rank.
- The full top 100 is cached once and sliced per request, so varying limit costs nothing extra.
Authentication
Send a
User-Agent header containing a contact email. See authentication.Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| genre | string | required | Genre name such as jazz, or a numeric genre ID such as 129. Names are matched loosely, so "hip hop" finds "Rap/Hip Hop". |
| type | string | optional | tracks (default), albums, artists or playlists. |
| limit | integer | optional | Results to return, 1-100. Defaults to 25. |
Request
curl 'https://api.synkradio.co.uk/genre/chart?genre=value' \
-H 'User-Agent: [email protected]'Try it
GETTry it
Sends a real requesthttps://api.synkradio.co.uk/genre/chart?genre=jazz&limit=10Response
200 application/json
{
"genre": "Pop",
"genreId": 132,
"type": "tracks",
"count": 2,
"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
},
{
"id": 3895241341,
"name": "Boston",
"artist": "STELLA LEFTY",
"artistId": 181157207,
"album": "Boston",
"albumId": 937796461,
"durationMs": 170000,
"explicit": false,
"isrc": null,
"rank": 873262,
"previewUrl": "https://cdnt-preview.dzcdn.net/api/1/1/a/d/f/0/adf281db3129088dd0e88c58e64a3ca3.mp3?hdnea=exp=1789426811~acl=/api/1/1/a/d/f/0/adf281db3129088dd0e88c58e64a3ca3.mp3*~data=user_id=0,application_id=42~hmac=526b4c0f6aeb3b4e2af342231f36461236908f9ed64a83a92c03b978a042e471",
"cover": "https://api.synkradio.co.uk/cover?artist=STELLA%20LEFTY&title=Boston",
"position": 2
}
]
}Response schema
| Field | Type | Example | Description |
|---|---|---|---|
| genre | string | "Pop" | |
| genreId | number | 132 | |
| type | string | "tracks" | |
| count | number | 2 | |
| tracks | array<object> | 2 items | Tracklist for the release. |