Melon Chart Parser

What's Melon Chart Parser?

Melon Chart Parser is a module that parses the melon chart and obtains the data of the songs.

Installation

npm install melon-chart-parser

yarn add melon-chart-parser

Examples

Get 10 songs from daily melon chart.

// var something = require('melon-chart-parser');
const melon = require('melon-chart-parser');

const opts = {
  limit: 10,
  type: 'daily'
};

// callback style
melon.parse(opts, function(res, err) {
  if (err) return;

  console.log(res);
});

// promise style
melon.parse(opts)
  .then(function(res) {
    console.log(res);
  })
  .catch(function(err) {
    console.log(err);
  });

Output should be like

[ { rank: 1,
    trackName: '남이 될 수 있을까',
    artistName: '볼빨간사춘기, 스무살',
    album: '남이 될 수 있을까' },
  { rank: 2,
    trackName: '무제(無題) (Untitled, 2014)',
    artistName: 'G-DRAGON',
    album: '권지용' },
  { rank: 3,
    trackName: '처음부터 너와 나',
    artistName: '볼빨간사춘기',
    album: '군주 - 가면의 주인 OST Part.2' },
  { rank: 4,
    trackName: 'Shape of You',
    artistName: 'Ed Sheeran',
    album: '÷ (Deluxe)' },
  { rank: 5,
    trackName: 'SIGNAL',
    artistName: 'TWICE (트와이스)',
    album: 'SIGNAL' },
  { rank: 6,
    trackName: '오늘 취하면 (Feat. 창모) (Prod. SUGA)',
    artistName: '수란 (SURAN)',
    album: 'WINE' },
  { rank: 7,
    trackName: 'New Face',
    artistName: '싸이 (PSY)',
    album: 'PSY 8th 4X2=8' },
  { rank: 8,
    trackName: 'NEVER',
    artistName: '국민의 아들',
    album: 'PRODUCE 101 - 35 Boys 5 Concepts' },
  { rank: 9,
    trackName: 'I LUV IT',
    artistName: '싸이 (PSY)',
    album: 'PSY 8th 4X2=8' },
  { rank: 10,
    trackName: '팔레트 (Feat. G-DRAGON)',
    artistName: '아이유',
    album: 'Palette' } ]

Get 50 songs of 2016-05's month chart.

const melon = require('melon-chart-parser');

const opts = {
  limit: 50,
  type: 'month',
  month: 5,
  year: 2016
};

melon.parse(opts, function(res, err) {
  if (err) return;

  console.log(res);
});

Get 100 songs of year chart.

const melon = require('melon-chart-parser');

const opts = {
  limit: 100,
  type: 'year',
  genre: 'KPOP', // or 'POP'
  year: 2015
};

melon.parse(opts, function(res, err) {
  if (err) return;

  console.log(res);
});

Get 100 songs of this week's chart by OST genre.

const melon = require('melon-chart-parser');

const opts = {
  limit: 100,
  type: 'genre',
  genre: 'DP0300', // A list of possible genres can be read at the bottom of the document.
};

melon.parse(opts, function(res, err) {
  if (err) return;

  console.log(res);
});

Get 50 songs of IU songs, which is ordered by popularity.

const melon = require('melon-chart-parser');

const opts = {
  limit: 50,
  type: 'artist',
  term: '아이유'
};

melon.parse(opts, function(res, err) {
  if (err) return;

  console.log(res);
});

Functions

parse(option, callback)

Parse melon chart.

Typedefs

getSongsCallback : function

Callback for getting chart information.

Options : Object

Request options.

parse(option, callback)

Parse melon chart.

Kind: global function

Param	Type	Description
option	Options	Information about the chart you will request.
callback	getSongsCallback	The callback that handles the response.

getSongsCallback : function

Callback for getting chart information.

Kind: global typedef

Param	Type	Description
res	Object	an array of songs.
err	Object	error while requesting chart page.

Options : Object

Request options.

Kind: global typedef
Properties

Name	Type	Default	Description
limit	number	50	option.limit Limit how many songs you will get (default 50, max 100).
type	string	"daily"	option.type The type of chart. (daily, week, year, genre)
genre	string	"KPOP"	option.genre The type of genre.
year	number	year of today	option.year Year.
month	number	month of today	option.month Month.

Genre list

when type is 'genre' you can send genre by genre parameter below value.

'DM0000' 국내종합,
'AB0000' 해외종합,
'GN0100' 발라드,
'GN0200' 댄스,
'GN0300' 랩/힙합,
'GN0400' R&B/Soul,
'GN0500' 인디음악,
'GN0600' 록/메탈,
'GN0700' 트로트,
'GN0800' 포크/블루스,
'GN0900' (해외) POP,
'GN1000' (해외) 록/메탈,
'GN1100' (해외) 일렉트로니카,
'GN1200' (해외) 랩/힙합,
'GN1300' (해외) R&B/Soul,
'GN1400' (해외) 포크/블루스/컨트리,
'GN1500' OST,
'GN1700' 재즈,
'GN1800' 뉴에이지,
'GN1900' J-POP,
'GN2000' 월드뮤직,
'GN2100' CCM,
'GN2200' 어린이/태교,
'GN2300' 종교음악,
'GN2400' 국악

or if type is 'year' you can send genre parameter below value.

'KPOP' (KPOP),
'POP' (POP)