API Reference
API Reference
Base URL: https://api.ml.jadquir.com/v1
All requests require Authorization: Bearer <key>. Get your key from the dashboard.
Endpoint
/lookup/:platform/:idResolve a track across all platforms. Pass a bare ID or a full platform URL. Results are cached — repeat lookups return instantly.
First lookup: If a track has never been resolved before, the API may take 10–15 seconds or more to respond while it fetches data across platforms. Subsequent requests for the same track return from cache immediately.
Accepted input platforms
| platform | example id |
|---|---|
| isrc | GBAHS1600463 |
| spotify | 5BhCnMoTq4qI4vf37Ohlkm |
| deezer | 139470659 |
| tidal | 352393347 |
| apple_music | 1826971718 |
Full platform URLs are also accepted — the ID is extracted automatically.
Response
{
"success": true,
"data": {
"public_id": "MKB7VjTG",
"title": "Shape of You",
"artist": "Ed Sheeran",
"isrc": "GBAHS1600463",
"image_url": "https://yt3.googleusercontent.com/TMbA3LImAL96nFkm5cI1x6LiEMvMbRg4IRxEeABd9qpXsfmwKhZHRD1MucnjG5QIsVEp0Vpn7h7M51FH3Q=w1500-h1500-l100-rj",
"links": {
"musiclink": "https://ml.jadquir.com//ml/MKB7VjTG", // Our own link for easy sharing
"spotify": "https://open.spotify.com/track/5BhCnMoTq4qI4vf37Ohlkm",
"youtube": "https://www.youtube.com/watch?v=xTvyyoF_LZY",
"youtube_music": "https://music.youtube.com/watch?v=xTvyyoF_LZY",
"deezer": "https://www.deezer.com/track/139470659",
"soundcloud": "https://soundcloud.com/edsheeran/shape-of-you",
"apple_music": "https://geo.music.apple.com/song/1826971718",
"tidal": "https://listen.tidal.com/track/352393347",
"qobuz": "https://open.qobuz.com/track/37680152",
"shazam": "https://www.shazam.com/song/1714453945/shape-of-you",
"yandex": "https://music.yandex.com/track/32947997",
"anghami": "https://play.anghami.com/song/21508959",
"napster": "https://play.napster.com/track/tra.248648524",
"pandora": "https://www.pandora.com/artist/ed-sheeran/deluxe/shape-of-you/TRxcxxhbgh3zXdK",
"boomplay": "https://www.boomplay.com/songs/3650888",
"audiomack": "https://audiomack.com/ed-sheeran/song/shape-of-you-3587400",
"amazon_music": "https://music.amazon.com/tracks/B01N7RAC65",
"amazon_store": "https://amazon.com/dp/B0DF7YZ28K"
}
}
}Examples
# By ISRC
curl https://api.ml.jadquir.com/v1/lookup/isrc/GBAHS1600463 \
-H "Authorization: Bearer <key>"
# By Spotify ID
curl https://api.ml.jadquir.com/v1/lookup/spotify/5BhCnMoTq4qI4vf37Ohlkm \
-H "Authorization: Bearer <key>"
# By Deezer ID
curl https://api.ml.jadquir.com/v1/lookup/deezer/139470659 \
-H "Authorization: Bearer <key>"
# By Tidal ID
curl https://api.ml.jadquir.com/v1/lookup/tidal/352393347 \
-H "Authorization: Bearer <key>"
# By Apple Music ID
curl https://api.ml.jadquir.com/v1/lookup/apple_music/1826971718 \
-H "Authorization: Bearer <key>"Rate limits
| Plan | Requests / month | Per second | Per minute |
|---|---|---|---|
| Free | 300 | 1 | 10 |
| Hobby | 5,000 | 2 | 60 |
| Pro | 50,000 | 5 | 200 |
When a limit is exceeded the API returns 429 with a Retry-After header.
Output platforms
Platform links are provided on a best-effort basis. Some links may be unavailable, inaccurate, or missing depending on the track, region, or platform catalog at the time of resolution. We cannot guarantee every platform link will be present or correct in every response.
MusicLink is our own shareable link — it always resolves to a page with all available platform links for the track.