# apple-music-metadata

> gets apple music metadata for songs, albums and playlists links

Latest version **2.0.1** (published 2022-08-31) · MIT license · 0 weekly downloads

## Install

```sh
npm install apple-music-metadata
pnpm add apple-music-metadata
yarn add apple-music-metadata
bun add apple-music-metadata
```

## Health

**Score 30/100 (F)** — status: abandoned.

Positive: has types; esm support; no vulnerabilities; high quality score.

Warnings: low downloads.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 2.0.1 |
| Published | 2022-08-31 |
| First published | 2021-10-29 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 2 |
| Unpacked size | 16.3 KB |
| Known vulnerabilities | 0 (+23 in 1 direct dependencies) |
| Install scripts | no |
| GitHub stars | 3 |
| Maintainers | night_hunterr |
| Keywords | typescript, music, apple music, apple music metadata |

## Links

- npm: https://www.npmjs.com/package/apple-music-metadata
- Repository: https://github.com/Night-Hunter-NF/apple-music-metadata
- Issues: https://github.com/Night-Hunter-NF/apple-music-metadata/issues
- npm.io page: https://npm.io/package/apple-music-metadata

## Dependencies (2)

- [axios](https://npm.io/package/axios.md) ^0.27.2
- [cheerio](https://npm.io/package/cheerio.md) ^1.0.0-rc.12

## Alternatives

- [@openai/codex-sdk](https://npm.io/package/@openai/codex-sdk.md) — 731.4K weekly downloads
- [babel-plugin-transform-react-jsx](https://npm.io/package/babel-plugin-transform-react-jsx.md) — 565.0K weekly downloads
- [babel-helper-remove-or-void](https://npm.io/package/babel-helper-remove-or-void.md) — 508.5K weekly downloads
- [@pnpm/store-controller-types](https://npm.io/package/@pnpm/store-controller-types.md) — 186.9K weekly downloads
- [react-native-signature-canvas](https://npm.io/package/react-native-signature-canvas.md) — 155.6K weekly downloads

## Recent versions

- 2.0.1 (latest) — 2022-08-31
- 2.0.0 — 2022-01-16
- 1.0.10 — 2021-12-29
- 1.0.9 — 2021-10-30
- 1.0.8 — 2021-10-30
- 1.0.7 — 2021-10-30
- 1.0.6 — 2021-10-29
- 1.0.5 — 2021-10-29
- 1.0.4 — 2021-10-29
- 1.0.3 — 2021-10-29
- 1.0.2 — 2021-10-29
- 1.0.1 — 2021-10-29
- 1.0.0 — 2021-10-29

## README

# apple-music-metadata

A TypeScript package for scraping Apple Music metadata (Supports single tracks, albums, and playlists).

# Installation

```
npm install apple-music-metadata
```

# Usage

## Single Track

```ts
import appleMusic from "apple-music-metadata";

appleMusic(
  "https://music.apple.com/us/album/example/1541902791?i=1541903021"
).then(console.log);

/*
{
  artist: {
    name: 'Sody',
    url: 'https://music.apple.com/us/artist/sody/271348279'
  },
  title: 'butterfly',
  duration: '189', in seconds
  url: 'https://music.apple.com/us/album/butterfly/1541902791?i=1541903021?i=1541903021',
  type: 'song'
}
*/
```

## Playlist

```ts
import appleMusic from "apple-music-metadata";

appleMusic(
  "https://music.apple.com/us/playlist/office-dj/pl.f820ed7063f9447f8751abf885525698"
).then(console.log);

/*
{
  title: 'Office DJ',
  description: "There's nothing like ...",
  creator: {
    name: 'Apple Music Pop',
    url: 'https://music.apple.com/us/curator/apple-music-pop/976439548'
  },
  tracks: [...]
  numTracks: 100,
  type: 'playlist'
}
*/
```

## Album

```ts
import appleMusic from "apple-music-metadata";

appleMusic(
  "https://music.apple.com/us/album/meditations-for-living-an-awakened-life/1602431360"
).then(console.log);

/*
{
  title: 'Meditations for Living an Awakened Life',
  description: '',
  artist: {
    name: 'Sarah Blondin',
    url: 'https://music.apple.com/us/artist/sarah-blondin/1602422414'
  },
  tracks: [
    ...
  ],
  numTracks: 7,
  type: 'album'
}
*/
```

---
_Source: https://npm.io/package/apple-music-metadata · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._