GET
/playlist/chartReturns a ready-made playlist of top tracks for a given genre. Country is auto-detected from your IP but you can override it. Good for building genre radios, mood feeds, or "what is hot in X" widgets.
Rate limit
30 req/min
Caching
Cached per genre and country in the internal database for 30 minutes.
Authentication
Send a
User-Agent header containing a contact email. See authentication.Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| genre | string | required | Genre name. Supported: pop, rock, electronic, hip-hop, jazz, classical, r&b, metal, soul, country. |
| country | string | optional | ISO 3166-1 alpha-2 country code. Auto-detected from your IP if not supplied. |
| limit | integer | optional | How many tracks to return. Between 1 and 100. Defaults to 20. |
Request
curl 'https://api.synkradio.co.uk/playlist/chart?genre=value' \
-H 'User-Agent: [email protected]'Try it
GETTry it
Sends a real requesthttps://api.synkradio.co.uk/playlist/chartResponse
200 application/json
{
"genre": "electronic",
"country": "GB",
"tracks": [
{
"position": 1,
"id": 2816065827,
"name": "Volta",
"artist": "Knife Party",
"artistId": 1098965,
"album": "Haunted House EP",
"durationMs": 230000,
"explicit": false,
"cover": "https://api.synkradio.co.uk/cover?artist=Knife+Party&title=Volta"
},
{
"position": 2,
"id": 67234751,
"name": "Around the World",
"artist": "Daft Punk",
"artistId": 27,
"album": "Homework",
"durationMs": 428000,
"explicit": false,
"cover": "https://api.synkradio.co.uk/cover?artist=Daft+Punk&title=Around+the+World"
}
]
}Response schema
| Field | Type | Example | Description |
|---|---|---|---|
| genre | string | "electronic" | |
| country | string | "GB" | |
| tracks | array<object> | 2 items | Tracklist for the release. |