Security News
The Dark Side of Open Source
At Node Congress, Socket CEO Feross Aboukhadijeh uncovers the darker aspects of open source, where applications that rely heavily on third-party dependencies can be exploited in supply chain attacks.
@statsfm/applemusic.js
Advanced tools
Readme
The Node.js client for Apple Music is a client library for Apple Music API built with TypeScript.
Currently this library provides only a feature to fetch a single resource such as album, artists, songs, playlists, music videos, or stations.
Note that this does not related to MusicKit JS, which is the official library of Apple Music for web apps.
You need to be a member of the Apple Developer Program and obtain your Apple Music developer token with some tools such as apple-music-token-node.
Install the package with:
yarn add @statsfm/applemusic.js
Type definitions for TypeScript are also included in the package.
You need to instantiate a client with your developer token:
import { AppleMusicAPI } from '@statsfm/applemusic.js';
const client = new AppleMusicAPI({
developerToken: 'YOUR_DEVELOPER_TOKEN',
mediaUserToken: 'YOUR_MUT' // optional
});
You can fetch album, artists, songs, playlists, music videos, or stations with client.RESOURCES.get()
:
async function main() {
const client = new AppleMusicAPI({ developerToken: 'YOUR_DEVELOPER_TOKEN' });
const playlistID = 'pl.5ee8333dbe944d9f9151e97d92d1ead9';
const response = await client.playlists.get(playlistID, { storefront: 'us' });
const playlist = response.data[0];
console.log(playlist.attributes!);
// {
// artwork: {
// width: 4320,
// height: 1080,
// url: 'https://is1-ssl.mzstatic.com/image/thumb/Features124/v4/f7/25/2e/f7252e6c-921b-6475-7b34-754f3ca0ef1a/source/{w}x{h}cc.jpeg',
// bgColor: '0051cc',
// textColor1: 'e4fe63',
// textColor2: 'f3e8f1',
// textColor3: 'b6db78',
// textColor4: 'c2c9ea'
// },
// isChart: false,
// url: 'https://music.apple.com/us/playlist/a-list-pop/pl.5ee8333dbe944d9f9151e97d92d1ead9',
// lastModifiedDate: 2020-02-14T05:00:26.000Z,
// name: 'A-List Pop',
// playlistType: 'editorial',
// curatorName: 'Apple Music Pop',
// playParams: { id: 'pl.5ee8333dbe944d9f9151e97d92d1ead9', kind: 'playlist' },
// description: {
// standard: "The title track from Sam Smith’s forthcoming third album, “To Die For” was inspired by Abbot Kinney—the iconic beach-adjacent boulevard in Los Angeles’ Venice neighborhood. “I was walking down there on a Sunday and everyone was happy because everyone's happy on that road,” Smith tells Apple Music. “Just partners everywhere, kissing, and families. And it's basically about that—about feeling alone and feeling like you're on the outside watching everyone else together.” Add A-List Pop to your library to stay up on the latest and greatest pop music.",
// short: `Sam Smith's new song is inspired by "the most beautiful road in America."`
// }
// }
}
main();
You can fetch playlists, artists, songs, playlists, music videos, or stations, library playlists and songs with client.RESOURCES.get()
:
async function main() {
const client = new AppleMusicAPI({
developerToken: 'YOUR_DEVELOPER_TOKEN',
mediaUserToken: 'YOUR_MUT'
});
const response = await client.library.playlists.getMany({ storefront: 'us' });
const playlists = response.data;
console.log(playlists);
// [
// {
// id: 'p.zp6KlXEiBvxMR8g',
// type: 'library-playlists',
// href: '/v1/me/library/playlists/p.zp6KlXOiBvdMR8g',
// attributes: {
// canEdit: false,
// name: 'My playlist',
// description: [Object],
// isPublic: false,
// artwork: [Artwork],
// hasCatalog: true,
// playParams: [PlayParameters],
// dateAdded: 2022-08-19T08:22:08.000Z
// }
// }
// ]
}
main();
You can handle API errors as:
async function main() {
const client = new AppleMusicAPI({ developerToken: 'YOUR_DEVELOPER_TOKEN' });
try {
const response = await client.playlists.get('nosuchplaylist', { storefront: 'us' });
} catch (error) {
console.log(error.httpStatusCode);
// 404
console.log(error.response.errors[0])
// {
// id: 'LVZEECBHZRR4HII432DE7VDF6E',
// title: 'Resource Not Found',
// detail: 'Resource with requested id was not found',
// status: '404',
// code: '40400'
// }
}
}
}
main();
You must specify storefront either:
defaultStorefront
parameter in the constructorstorefront
parameter in get()
const client = new AppleMusicAPI({
developerToken: 'YOUR_DEVELOPER_TOKEN',
defaultStorefront: 'us'
});
const response = await client.playlists.get(playlistID);
const client = new AppleMusicAPI({
developerToken: 'YOUR_DEVELOPER_TOKEN'
});
const response = await client.playlists.get(playlistID, { storefront: 'us' });
You can specify language tag either:
defaultLanguageTag
parameter in the constructorlanguageTag
parameter in get()
const client = new AppleMusicAPI({
developerToken: 'YOUR_DEVELOPER_TOKEN',
defaultStorefront: 'jp'
});
// The storefront's default
const response = await client.playlists.get(playlistID);
const client = new AppleMusicAPI({
developerToken: 'YOUR_DEVELOPER_TOKEN',
defaultStorefront: 'jp',
defaultLanguageTag: 'en-US'
});
const response = await client.playlists.get(playlistID);
const client = new AppleMusicAPI({
developerToken: 'YOUR_DEVELOPER_TOKEN',
defaultStorefront: 'jp'
});
const response = await client.playlists.get(playlistID, { languageTag: 'en-US' });
Copyright (c) 2022 StatsFM B.V.
See the LICENSE.txt for details.
FAQs
Statically typed SDK for the Apple Music Web API
The npm package @statsfm/applemusic.js receives a total of 2 weekly downloads. As such, @statsfm/applemusic.js popularity was classified as not popular.
We found that @statsfm/applemusic.js demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 2 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
At Node Congress, Socket CEO Feross Aboukhadijeh uncovers the darker aspects of open source, where applications that rely heavily on third-party dependencies can be exploited in supply chain attacks.
Research
Security News
The Socket Research team found this npm package includes code for collecting sensitive developer information, including your operating system username, Git username, and Git email.
Security News
OpenJS is warning of social engineering takeovers targeting open source projects after receiving a credible attempt on the foundation.