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

$3

`javascript
// 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

`javascript
[ { 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' } ]
`

$3


`javascript
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);
});
`

$3


`javascript
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);
});
`

$3


`javascript
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);
});
`

$3


`javascript
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)
``