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.
Notes
- One of id, isrc, or both artist and title must be provided.
- Chart data is cached per country for 30 minutes so positions may lag slightly.
- Falls back to the global chart if your country does not have one.
- Returns 404 if the track is not currently in the top 100 for that country.
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=USQX91300809&artist=ROSE&title=APT.&country=USResponse
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 |