GET
/track/chartReturns the current chart position of a track for a given country. Country is auto-detected from your IP but you can override it. Returns a 404 if the track is not in the current top 100.
Rate limit
30 req/min
Caching
Chart data cached in the internal database per country for 30 minutes.
Authentication
Send a
User-Agent header containing a contact email. See authentication.Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| id | string | optional | Internal track ID. |
| isrc | string | optional | ISRC code. Skips a search round trip. |
| artist | string | optional | Artist name. Needed if you are not passing an id or isrc. |
| title | string | optional | Track title. Needed if you are not passing an id or isrc. |
| country | string | optional | ISO 3166-1 alpha-2 country code e.g. GB, US, DE. Auto-detected from your IP if not supplied. |
Request
curl 'https://api.synkradio.co.uk/track/chart' \
-H 'User-Agent: [email protected]'Try it
GETTry it
Sends a real requesthttps://api.synkradio.co.uk/track/chart?isrc=GBUM71505078&artist=Daft%20Punk&title=Around%20the%20WorldResponse
200 application/json
{
"position": 1,
"country": "GB",
"chartSize": 100,
"track": {
"position": 1,
"id": 2816065827,
"name": "APT.",
"artist": "ROSE",
"artistId": 5729501,
"album": "rosie",
"durationMs": 173000,
"explicit": false,
"cover": "https://api.synkradio.co.uk/cover?artist=ROSE&title=APT."
}
}Response schema
| Field | Type | Example | Description |
|---|---|---|---|
| position | number | 1 | |
| country | string | "GB" | |
| chartSize | number | 100 | |
| track | object | 9 fields |