Melon

Get Music Chart

[Purpose] Retrieves various official music ranking charts from Melon(멜론). [Details] Returns music rankings based on multiple criteria, including TOP 100, Daily/Weekly, and HOT TRACK. The response includes each song's rank, title, artist, and ID. [Usage Guide] - Use when users request music rankings. —"TOP 100 차트 보여줘", "오늘 인기 제일 많은 노래 뭐야?" - If a request includes both a specific time period (e.g., daily/weekly) and additional conditions, such as "이번주 인기 발라드 알려줘", it is recommended to first retr

Get Playlist Tracks

[Purpose] Retrieves tracks in a specific playlist on Melon(멜론) using its ID. [Details] Retrieves detailed information for all tracks included in the specified playlist using the playlist ID. The response includes each track's title, artist, and ID. [Usage Guide] Use when users request the tracks in a specific playlist. —"이 플레이리스트에 있는 노래 목록 보여줘".

Get Music Content Details

[Purpose] Retrieves detailed information about songs, albums, and artists on Melon(멜론) using their IDs. [Details] Uses content IDs obtained from other tools (e.g., search, chart) to retrieve detailed information such as release date, genre, and description. The tool supports parallel processing for retrieving multiple IDs in a single request. For single-ID queries, the result is returned directly. For multiple-ID queries, results are returned grouped by each ID. [Usage Guide] - Single Retriev

Get Artist Contents

[Purpose] Retrieves a list of tracks or albums for a specific artist from Melon(멜론). [Details] Retrieves specific artist's tracks or albums by using the artist ID, with filters based on participation type (all, featuring, lyricist/composer, etc.). If multiple versions of the same track (e.g., remix, live) exist, they are deduplicated and returned as a single entry. [Usage Guide] - Use when users request tracks by a specific artist —"아이유 노래 목록 보여줘", "박재범이 피처링한 노래 찾아줘". - Use when users request

Get Music Content Url

[Purpose] Returns detail page URLs for content on Melon(멜론), such as songs, albums, or playlists. [Details] Generates and returns web URLs for viewing detailed information about content. [Usage Guide] Use when users request detailed information about specific content —"이 노래 정보 보여줘", "앨범 정보"— or when providing an additional link. Note that playlists returned in search results are DJ playlists. [Integration] Pass a content ID obtained from other tools (e.g., songId, albumId) to the content_id o

Get Genres

[Purpose] Retrieves main genres and all their sub-genres on Melon(멜론) in a nested structure. [Details] Specify genre_code to retrieve information for the corresponding genre and its sub-genres only. If omitted, retrieves all available genres. Returns a mapping of genre codes to their descriptions and sub-genres. [Usage Guide] Use when users request genre information. Identify the most appropriate genre code from the returned list and use it as genre_code and sub_genre_code for `get_music_conte

Get Music Contents By Genre

[Purpose] Retrieves a list of songs, playlists, or classic albums belonging to a specific music genre on Melon(멜론). [Details] - 'songs': returns all songs classified under the genre, with optional sub-genre filtering. - 'popular_songs': returns the genre's hot tracks from Melon's official curated "Hot Tracks" playlist (operated by '장르HoTracks' DJ), reflecting the actual popularity ranking of the genre. - 'playlists': returns playlists featuring that genre. - 'masterpieces': returns classic/repr

Get Recently Played Music Contents

[Purpose] Retrieves users' recently played songs or recently viewed playlists on Melon(멜론). [Details] Retrieves a list of 'recently played songs' or 'recently viewed playlists' based on the user's listening and viewing history. The API provides a fixed maximum of 100 items. The page/limit parameters only paginate within this fixed dataset. [Usage Guide] Use when users request their recent activity history. —"최근에 들은 노래 뭐야?", "아까 봤던 플레이리스트 다시 보고 싶어".

Get My Created Playlists

[Purpose] Retrieves a list of playlists 'created by me' on Melon(멜론). [Details] Retrieves playlists the user has created and owns: standard playlists ('My Playlist'), DJ playlists ('My DJ Playlist'), and the full list of user-created playlists. [Usage Guide] Use when users request their own playlists. —"내가 만든 플레이리스트 보여줘", "내 플레이리스트 목록", "내 DJ 플레이리스트 찾아줘". [Distinction] `get_my_liked_music_contents` retrieves playlists that the user has liked, whereas this tool retrieves playlists the user has

Get My Most Listened Songs

[Purpose] Retrieves the ranking of the user's most played songs over a specified period on Melon(멜론). [Details] - Retrieves a ranked list of the most played songs based on the user's listening statistics for one of the following periods: the last 1 week, 1 month, 3 months, a specific month (YYYYMM), or a specific date (YYYYMMDD). - Multiple periods can be queried in a single request. - A maximum of 100 songs can be retrieved per request. - term_list parameter supports both single-period and mul

Get My Liked Music Contents

[Purpose] Retrieves a list of all types of content the user has 'liked' on Melon(멜론). [Details] This tool provides comprehensive access to users' liked content across multiple categories. Retrieves all content types that the user has 'liked', including songs, albums, playlists (standard playlists, DJ playlists, artist playlists, or all playlists if unspecified), videos, genres, and tags. [Usage Guide] Use when users request content related to their likes. —"내가 좋아요 한 노래 목록 보여줘", "좋아요 누른 앨범들 찾아줘

Get Latest Music Contents

[Purpose] Retrieves a list of newly released songs, albums, and videos on Melon(멜론), sorted by release date. [Details] Applies region filters (domestic/international) when retrieving a list of newly released content. [Usage Guide] Use when users request newly released content regardless of ranking. —"새로 나온 노래 뭐 있어?", "최신 앨범 목록 보여줘". [Distinction] 'NEWEST' type in `get_music_chart` returns a popularity ranking of new songs, whereas this tool provides a list sorted strictly by release date, reg

Create Playback Url

[Purpose] Generates a playback URL for given content (song, album, playlist, music video) on Melon(멜론). [Details] Generates and returns web URLs that allow users to play content directly. [Usage Guide] - Play songs: Pass a list of song_id values into the song_ids parameter. - Play playlists: Pass a list of playlist_seq values into the playlist_seqs parameter. - Play albums: Pass a list of album_id values into the album_ids parameter. - Play music video: Pass a single mv_id into the mv_id param

Get Melon Curated Playlists

[Purpose] Retrieves a list of official playlists curated and recommended by Melon(멜론). [Details] Retrieves playlists from Melon's official recommendation categories, such as 'Daily Pick', 'Today's Playlist', and 'Theme Recommendation'. [Usage Guide] Use when users request Melon's official recommendations. —"멜론 추천 플레이리스트", "오늘의 플레이리스트". [Distinction] If the user mentions contextual or mood-based keywords such as "driving" or "workout", use `search_melon_music_contents` tool instead of this too

Search Melon Music Contents

[Purpose] Searches for all types of content on Melon(멜론)—songs, albums, artists, videos, playlists—using keywords. [Details] Performs a unified search based on user-provided keywords, or narrows the search scope by specifying a content type. Search results include unique IDs that can be used in other tools. [Usage Guide] - Use as the primary tool for general search requests. —"밤편지 앨범 검색해줘", "싫은날이라는 곡 찾아줘", "집중하기 좋은 음악 추천해줘". - When searching for playlists or recommended songs related to mood,

Recommend Personalized Songs By Dj Mallang

[Purpose] Provides personalized song recommendations based on the user's music preference on Melon(멜론). [Details] Uses Melon's personalized recommendation engine, "DJ Mallang (DJ말랑이)", to comprehensively analyze the user's listening history, likes, and playlists in order to recommend new songs the user is likely to enjoy. [Usage Guide] Use when users request music recommendations without specifying criteria. —"나한테 맞는 노래 추천해줘", "들을만한 노래 없어?"

Recommend Similar Songs By Dj Mallang

[Purpose] Recommends other songs with a similar mood or genre to the specific song on Melon(멜론). [Details] Analyzes the musical characteristics of the reference song to recommend up to 30 other songs with similar styles. [Usage Guide] Use when users request songs similar to the reference song. —"이 노래랑 비슷한 노래 찾아줘", "이런 스타일의 다른 곡 추천해줘".

Get Song Streaming Report

[Purpose] Provides streaming statistics or personal listening history for a specific song on Melon(멜론). [Details] Provides two types of reports depending on report_type: - 'public': Quickly assesses the song's overall popularity on Melon through key metrics (total streaming count, total number of listeners). - 'my': Shows the number of times the user has played the specific song and the date when it was first played. [Usage Guide] - "이 노래 인기 많아?", "사람들이 이 노래 얼마나 들었어?" → report_type="public" -