/vibe-chart.py

💓 Python API for downloading Naver Vibe charts | 네이버 바이브 차트 API

Primary LanguagePythonMIT LicenseMIT

💓 바이브 차트 API: vibe-chart.py

vibe

vibe-chart.py is a Python API that retrieves the TOP 100 information from the Naver Vibe.

Installation

pip install vibe-chart.py

Quickstart

The main usage of vibe-chart.py is similar to billboard.py.

>>> from vibe import *
>>> chart = ChartData(image_size=500)
>>> print(chart[0].json())
{
    "artist": "IVE(아이브)",
    "image": "https://musicmeta-phinf.pstatic.net/album/009/334/9334427.jpg?type=r500Fll&v=20230404132130",
    "isNew": false,
    "lastPos": 1,
    "rank": 1,
    "title": "Kitsch"
}
>>> print(chart.name)
오늘 Top 100
>>> print(chart.date)
2023-04-09 07:00:00

ChartData Arguments

  • name – The chart name
  • date – The chart date
  • queryStart – The starting index of the chart entries to be retrieved from the Vibe API. (default: 1)
  • queryCount – The number of items to retrieve from the API response, starting from queryStart. (default: 100)
  • imageSize – The size of cover image for the track. (default: 256)
  • fetch – A boolean value that indicates whether to retrieve the chart data immediately. If set to False, you can fetch the data later using the fetchEntries() method.

Chart entry attributes

ChartEntry can be accessed using the ChartData[index] syntax. A ChartEntry instance has the following attributes:

  • title – The title of the track
  • artist – The name of the artist
  • image – The URL of the cover image for the track
  • lastPos - The track's last position on the previous period.
  • rank – The track's current rank position on the chart.
  • isNew – Whether the track is new to the chart.

K-Pop music chart Python APIs

Dependencies

License

This project is licensed under the MIT License.