napthedev/nhaccuatui-api-full

NhacCuaTui API Full

NhacCuaTui API Library with Typescript support Support Nodejs server, client request (with proxy built in)

Original Library

👉 nhaccuatui-api 👈
Respect a lot ❤️ 🙏

Installation

npm i nhaccuatui-api-full

Common JS

const NhacCuaTui = require("nhaccuatui-api-full");

// or

const {
  getHome,
  getSong,
  getPlaylists,
  //... and many other services
} = require("nhaccuatui-api-full");

ES Import

import NhacCuaTui from "nhaccuatui-api-full";

// or

import {
  getHome,
  getSong,
  getPlaylists,
  //... and many other services
} from "nhaccuatui-api-full";

To use this library with Vite remember to add this plugin @originjs/vite-plugin-commonjs

Usage

Get Data

// .then
getHome().then((data) => console.log(data));
// or
NhacCuaTui.getHome().then((data) => console.log(data));

// async - await
(async () => {
  const data = await getHome();
  // or
  const data = await NhacCuaTui.getHome();
})();

1. Get Home

Get the data display on the homepage (Include song, artist, playlists, trending, ...)

getHome();

2. Get Song

Get the song detail
Example Link: https://beta.nhaccuatui.com/bai-hat/buoc-qua-nhau-vu.EdENCgJm9dAa.html
Then the ID is: EdENCgJm9dAa

getSong("SONG_ID");

3. Get Playlists

Get the list of popular playlists

getPlaylists();

4. Get Playlist Detail

Get the playlist detail
Example Link: https://beta.nhaccuatui.com/playlist/nhac-viet-hot-thang-12-va.7ROXQyroRFYT.html
Then the ID is: 7ROXQyroRFYT

getPlaylistDetail("PLAYLIST_ID");

5. Get Lyric

Get the lyric in text and LRC file

getLyric("SONG_ID");

6. Get Video / MV Detail

Get Music Video detail Example Link: https://beta.nhaccuatui.com/video/co-hen-voi-thanh-xuan-monstar.IXTbg1bBelQKh.html
Then the ID is: IXTbg1bBelQKh

getVideoDetail("VIDEO_ID");

7. Get Topics

Get popular topics

getTopics();

8. Get Topic Detail

Get the topic detail
Example Link: https://beta.nhaccuatui.com/chu-de/hot-v-pop.weiwjycnu.html
Then the ID is: weiwjycnu

getTopicDetail("TOPIC_ID");

9. Get Chart

Get Top Songs

Parameters

• Category (Optional). Default: "nhac-viet"
• Time (Optional)
  • Week: number
  • Year: number

// Use default option
getChart();

// or custom property
getChart({
  category: "nhac-viet",
  time: {
    week: 48,
    year: 2021,
  },
});

10. Get Top 100

Get the top 100 song of the playlist

Example Link: https://beta.nhaccuatui.com/top100/top-100-nhac-tre.m3liaiy6vVsF.html So the ID is: m3liaiy6vVsF

getTop100("TOP_100_ID");

11. Search by Keyword

Search songs, playlists, artists,... by keyword

searchByKeyword("SEARCH_KEYWORD");

12. Get Top Keywords

Get top searched keywords

getTopKeyword();

13. Get trending artists

Get top 10 artists

getTrendingArtists();

14. Explore artists

Parameters

• nation (Optional) - Default: "hot"
• gender (Optional) - Default: 1 (men)

// Default options
exploreArtists();

// Or With options
exploreArtists({
  nation: "hot",
  gender: 1,
});

15. Get artist Detail

Get one artist detail Example Link: https://beta.nhaccuatui.com/nghe-si-erik.html
Then the ID is: erik

getArtistDetail("ARTIST_ID");

16. Explore (Song, Playlist, MV)

Parameters

• type (Required) - "song" || "playlist" || "mv"
• key (Optional) - Default: "moi-hot"
• page (Optional) - Default: 1
• pageSize (Optional) - Default: 36

// Default options
explore({
  type: "song", // or "playlist" or "mv"
});

// With more options
explore({
  type: "song",
  key: "moi-hot",
  page: 1,
  pageSize: 36,
});

Summary

🤩✨ If you enjoy using this library, give me a star on Github and share it to your friends. ✨🤩

✅ If you have an error caused by the api, maybe NhacCuaTui has updated. Try to update to the latest version, if not working, submit an Issue on the repository ✅