Music URL Lookup API

The Musicfetch URL lookup API resolves a music-service link into normalized metadata and matching links on other platforms. Use it for song-link matching, album-link matching, artist-link matching, and cross-platform music metadata enrichment.

The /url endpoint accepts a URL from any supported music platform and returns normalized metadata with links to the same content across all requested services.

If you are evaluating the product workflow rather than endpoint parameters, start with the music link matching API overview.

Example

curl "https://api.musicfetch.io/url?url=https://open.spotify.com/track/6habFhsOp2NvshLv26DqMb&services=appleMusic,youtube" \
  -H "x-token: YOUR_TOKEN"

Endpoint

GET https://api.musicfetch.io/url

Query parameters

A music link from a supported platform: amazon,appleMusic,audiomack,awa,beatport,traxsource,deezer,discogs,iHeartRadio,joox,kkbox,netease,qobuz,qqMusic,shazam,soundcloud,spotify,tidal,trebel,yandex,youseeMusik,youtube

A comma-separated list of music services to fetch matching data from (eg. …?services=appleMusic,youtube,amazonMusic).

Possible enum values

amazonamazonMusicanghamiappleMusicaudiomackaudiusawabandcampbeatporttraxsourceboomplaydeezerdiscogsflogaanageniusiHeartRadioinstagramjioSaavnjooxkkboxlineMusicneteasemusicBrainzpandoraqobuzqqMusicsevenDigitalshazamsoundcloudspotifytidaltiktoktrebelyandexyouseeMusikyoutubeyoutubeMusic

The country to fetch local links for (eg. US, GB, FR)

Possible enum values

ADAEAGAIAMARATAUAZBBBEBGBHBJBMBOBRBWBYBZCACGCHCLCNCOCRCVCYCZDEDKDMDOECEEEGESFIFJFMFRGBGDGHGMGRGTHKHNHUIDIEILINISITJOJPKEKGKHKNKRKYKZLALBLCLILKLTLULVMCMDMLMNMOMTMUMWMXMYNENGNINLNONPNZOMPAPEPGPHPLPTPWPYRORUSASBSESGSISKSLSTSVSZTDTHTJTMTRTTTWUAUGUSUYUZVEVGVNYEZAZW

URL lookup API FAQ

What is the Musicfetch URL lookup API?

The URL lookup API accepts a supported music-service URL and returns normalized metadata with matching links across requested services.

Can URL lookup convert one song link to another service?

Yes. Provide a source track URL and request the destination service in the services parameter to get a matching song link when available.

What kinds of URLs does Musicfetch support?

Musicfetch supports lookup for supported track, album, and artist URLs from music services such as Spotify, Apple Music, YouTube, Deezer, TIDAL, SoundCloud, and more.

Try it out

Use the interactive playground below to test the URL lookup endpoint with your own parameters. The playground will show you the exact request and response.

GET https://api.musicfetch.io/url

url*

services*

Spotify

Apple Music

Music services to fetch data from

country

The country to fetch local links for (eg. US, GB, FR)

200

{
"result": {
"type": "track",
"name": "Cruel Summer",
"image": { 3 items },
"duration": 178426,
"isrc": "USUG11901472",
"isExplicit": false,
"previewUrl": "https://audio-ssl.itunes.apple.com/itunes-assets/AudioPreview221/v4/44/af/81/44af8168-9609-1b85-5048-ada08dceacf3/mzaf_1341699644335558812.plus.aac.p.m4a",
"releaseDate": "2023-07-07T00:00:00.000Z",
"label": "Taylor Swift",
"genres": [ 1 item ],
"copyright": "℗ 2019 Taylor Swift",
"services": { 3 items },
"artists": [ 1 item ],
"albums": [ 2 items ]
}
}

GET https://api.musicfetch.io/url

{
"result": {
"type": "track",
"name": "Cruel Summer",
"image": { 3 items },
"duration": 178426,
"isrc": "USUG11901472",
"isExplicit": false,
"previewUrl": "https://audio-ssl.itunes.apple.com/itunes-assets/AudioPreview221/v4/44/af/81/44af8168-9609-1b85-5048-ada08dceacf3/mzaf_1341699644335558812.plus.aac.p.m4a",
"releaseDate": "2023-07-07T00:00:00.000Z",
"label": "Taylor Swift",
"genres": [ 1 item ],
"copyright": "℗ 2019 Taylor Swift",
"services": { 3 items },
"artists": [ 1 item ],
"albums": [ 2 items ]
}
}

Ready to build with URL lookup?

Start a Musicfetch trial to resolve music-service URLs into metadata and matching links across supported platforms.

View pricing