Skip to main content

Python API for downloading Naver Vibe charts

Project description

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.

Dependencies

License

This project is licensed under the MIT License.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

vibe-chart.py-1.0.1.tar.gz (4.4 kB view hashes)

Uploaded Source

Built Distribution

vibe_chart.py-1.0.1-py3-none-any.whl (4.9 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page