GET
/resolvePaste any Spotify, Deezer, Apple Music, YouTube Music or SoundCloud URL and get back a canonical track, artist, album or playlist using our standard schema. Handy for cross-platform tools: user pastes a link, you get back a consistent object regardless of where it came from.
Rate limit
60 req/min
Caching
Cached in the internal database for 24 hours keyed on source+type+id.
Notes
- Detects source, type (track/artist/album/playlist), and id from the URL.
- For Spotify URLs we use oEmbed (no auth required), then search upstream to match.
- For Apple Music URLs we use iTunes Lookup, then map via ISRC when available for accuracy.
- For YouTube URLs we parse the video oEmbed title ("Artist - Title") and best-effort search upstream.
- SoundCloud resolution is slug-based best-effort since the SoundCloud API is gated.
- Branch on the `type` field: when type="track" the `data` object matches /track/info; type="artist" matches /artist/info; type="album" matches /album/info; type="playlist" matches /playlist/info.
Authentication
Send a
User-Agent header containing a contact email. See authentication.Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| url | string | required | Full URL from Spotify, Deezer, Apple Music, YouTube (Music), or SoundCloud. Locale prefixes like /intl-de/ or /en/ are handled. |
Request
curl 'https://api.synkradio.co.uk/resolve?url=value' \
-H 'User-Agent: [email protected]'Try it
GETTry it
Sends a real requesthttps://api.synkradio.co.uk/resolve?url=https%3A%2F%2Fopen.spotify.com%2Ftrack%2F3n3Ppam7vgaVa1iaRUc9LpResponse
200 application/json
{
"type": "track",
"source": "spotify",
"originalUrl": "https://open.spotify.com/track/3n3Ppam7vgaVa1iaRUc9Lp",
"data": {
"id": 3135556,
"name": "Mr. Brightside",
"isrc": "USIR20400274",
"artists": [
{
"id": 92,
"name": "The Killers"
}
]
}
}Response schema
| Field | Type | Example | Description |
|---|---|---|---|
| type | string | "track" | |
| source | string | "spotify" | Origin of the data, for example deezer, musixmatch. |
| originalUrl | string | "https://open.spotify.com/track/3n3Ppam7v…" | |
| data | object | 4 fields |