GET
/track/hotReturns the top charting tracks for a country. Country is auto-detected from your IP via Cloudflare geo headers, but you can override it if you want.
Rate limit
30 req/min
Caching
Cached per 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 |
|---|---|---|---|
| country | string | optional | ISO 3166-1 alpha-2 country code e.g. GB, US, DE. Leave it out and it gets worked out from your IP. |
| limit | integer | optional | How many tracks to return. Between 1 and 100. Defaults to 20. |
Request
curl 'https://api.synkradio.co.uk/track/hot' \
-H 'User-Agent: [email protected]'Try it
GETTry it
Sends a real requesthttps://api.synkradio.co.uk/track/hotResponse
200 application/json
{
"country": "GB",
"tracks": [
{
"position": 1,
"id": 2816065827,
"name": "APT.",
"artist": "ROSÉ",
"artistId": 5729501,
"album": "rosie",
"durationMs": 173000,
"explicit": false,
"cover": "https://api.synkradio.co.uk/cover?artist=ROSÉ&title=APT."
},
{
"position": 2,
"id": 2903421987,
"name": "Die With A Smile",
"artist": "Lady Gaga",
"artistId": 1374,
"album": "Die With a Smile",
"durationMs": 251000,
"explicit": false,
"cover": "https://api.synkradio.co.uk/cover?artist=Lady+Gaga&title=Die+With+A+Smile"
}
]
}Response schema
| Field | Type | Example | Description |
|---|---|---|---|
| country | string | "GB" | |
| tracks | array<object> | 2 items | Tracklist for the release. |