✶ API Endpoint:
/api/artist:song
⤍ Do NOT overlook the colon (:) in between the artist name & song name.
⤍ You can only make 60 requests per minute. PLEASE DO NOT ABUSE THE API.
⤍ Check example usage using Python & JavaScript on GitHub.
Schema
Status Code: 200 ⤍ Response Type: JSON Object
- album_art:
string - album_title:
string - album_type:
string - artists:
string - deezer:
string|null - genre:
string|null - itunes:
string|null - lyrics:
string|null - release_date:
string - spotify:
string|null - title:
string - ytmusic:
object|null- id:
string - url:
string
- id:
Status Code: 404 ⤍ Response Type: JSON Object
- error:
string
≻ Request Individual Platforms:
It is possible to request individual streaming platforms for information by passing the name of the platform as an empty query parameter:
/api/artist:song?platform
⤍ This parameter is optional.
⤍ The following streaming platforms are available:
⤍ deezer
⤍ itunes or apple-music
⤍ spotify
⤍ ytmusic
Schema
Status Code: 200 ⤍ Response Type: JSON Object
- album_art:
string - album_title:
string - album_type:
string - artists:
string - genre:
string|null - id:
string - isrc:
string|null - lyrics:
string|null - release_date:
string - tempo:
string|null - title:
string - upc:
string|null - url:
string
Status Code: 404 ⤍ Response Type: JSON Object
- error:
string
≻ Example of Requesting Individual Platform:
This will only return the result from Spotify:
/api/artist:song?spotify
✶ Response Examples:
/api/Rick Astley:Never Gonna Give You Up
Status Code: 200 OK:
⤍ Note that NOT always all the information will be returned (e.g. lyrics can be "null").
⤍ While I try my best, (but) there is NO guarantee that all the information will be correct.
{
'album_art': 'https://i.scdn.co/image/ab67616d0000b27315ebbedaacef61af244262a8',
'album_title': 'Whenever You Need Somebody',
'album_type': 'album',
'artists': 'Rick Astley',
'deezer': 'https://www.deezer.com/track/781592622',
'genre': 'Pop',
'itunes': 'https://music.apple.com/us/album/never-gonna-give-you-up-2022-remaster/1612648318?i=1612648319&uo=4',
'lyrics': null,
'release_date': '1987-11-12',
'spotify': 'https://open.spotify.com/track/4PTG3Z6ehGkBFwjybzWkR8',
'title': 'Never Gonna Give You Up',
'ytmusic': {
'id': 'dQw4w9WgXcQ',
'url': 'https://music.youtube.com/watch?v=dQw4w9WgXcQ'
}
}
Status Code: 404 NOT FOUND:
{
'error': "Couldn't find 'Song' by 'Artist'"
}
