ITunesAPI Class
ITunesAPI クラスは、iTunes API を使用して音楽トラックを検索するための TypeScript クラスです。
使用方法
インポート
import {ITunesAPI} from "@taka2829/itunes-track-api";トラックの検索
// 検索オプションを設定
const searchOption: APIOption = {
term: "TM NETWORK", // 検索キーワード
limit: 5, // 検索結果の最大数
};
const results: Track[] = await ITunesAPI.searchTracks(searchOption);サンプル
[
{
"wrapperType": "track",
"kind": "song",
"artistId": 265737160,
"collectionId": 1701373394,
"trackId": 1701373807,
"artistName": "TM NETWORK",
"collectionName": "Whatever Comes - Single",
"trackName": "Whatever Comes",
"collectionCensoredName": "Whatever Comes - Single",
"trackCensoredName": "Whatever Comes",
"artistViewUrl": "https://music.apple.com/jp/artist/tm-network/265737160?uo=4",
"collectionViewUrl": "https://music.apple.com/jp/album/whatever-comes/1701373394?i=1701373807&uo=4",
"trackViewUrl": "https://music.apple.com/jp/album/whatever-comes/1701373394?i=1701373807&uo=4",
"previewUrl": "https://audio-ssl.itunes.apple.com/itunes-assets/AudioPreview116/v4/c6/92/5e/c6925e03-0b32-78cd-2832-de6a1f89f2c7/mzaf_11094352269459584552.plus.aac.p.m4a",
"artworkUrl30": "https://is4-ssl.mzstatic.com/image/thumb/Music126/v4/13/63/18/136318a5-bab5-0d7f-4fd6-a41206d7dbf1/4547366638233.jpg/30x30bb.jpg",
"artworkUrl60": "https://is4-ssl.mzstatic.com/image/thumb/Music126/v4/13/63/18/136318a5-bab5-0d7f-4fd6-a41206d7dbf1/4547366638233.jpg/60x60bb.jpg",
"artworkUrl100": "https://is4-ssl.mzstatic.com/image/thumb/Music126/v4/13/63/18/136318a5-bab5-0d7f-4fd6-a41206d7dbf1/4547366638233.jpg/100x100bb.jpg",
"collectionPrice": 255,
"trackPrice": 255,
"releaseDate": "2023-08-23T12:00:00Z",
"collectionExplicitness": "notExplicit",
"trackExplicitness": "notExplicit",
"discCount": 1,
"discNumber": 1,
"trackCount": 1,
"trackNumber": 1,
"trackTimeMillis": 292693,
"country": "JPN",
"currency": "JPY",
"primaryGenreName": "J-Pop",
"isStreamable": true
},
...
]オプション
searchTracks メソッドに渡すことができる検索オプションの詳細については、APIOption インターフェースを参照してください。