billboard charts

Billboard.py

Billboard.py是用於從Billboard.com訪問音樂表的Python API。

安裝

使用PIP安裝：

 pip install billboard.py

或克隆此倉庫並運行python setup.py install 。

Quickstart

要下載廣告牌圖，我們使用ChartData()構造函數。

讓我們獲取當前的熱熱圖表。

 >> > import billboard
>> > chart = billboard . ChartData ( 'hot-100' )
>> > chart . title
'The Hot 100'

現在，我們可以查看圖表條目，這些條目是類型ChartEntry ，並且具有artist和title等屬性：

 >> > song = chart [ 0 ]  # Get no. 1 song on chart
>> > song . title
'Nice For What'
>> > song . artist
'Drake'
>> > song . weeks  # Number of weeks on chart
2

我們還可以print整個圖表：

 >>> print(chart)
hot-100 chart from 2018-04-28
-----------------------------
1. 'Nice For What' by Drake
2. 'God's Plan' by Drake
3. 'Meant To Be' by Bebe Rexha & Florida Georgia Line
4. 'Psycho' by Post Malone Featuring Ty Dolla $ign
5. 'The Middle' by Zedd, Maren Morris & Grey
# ...

指導

存在哪些圖表？

此頁面顯示按類別分組的所有圖表。

年末圖表在這裡。

下載圖表

使用ChartData構造函數下載圖表：

 ChartData ( name , date = None , year = None , fetch = True , timeout = 25 )

論點是：

• name - 圖表名稱，例如'hot-100'或'pop-songs' 。
• date - 圖表日期作為字符串，YYYY-MM-DD格式。默認情況下，獲取了最新圖表。
• year - 圖表年，如果要求年終圖表。必須是Yyyy格式的字符串。無法提供date和year 。
• fetch - 布爾值，指示是否立即（在實例化時間）從Billboard.com獲取圖表數據。如果是False ，則可以使用fetchEntries()方法在以後填充圖表數據。
• max_retries - 請求數據時要重試的最大次數（默認值：5）。
• timeout - 等待服務器響應的秒數。如果None ，則不會應用超時。

例如，要下載2006年的替代歌曲年終圖表：

 >> > chart = billboard . ChartData ( 'alternative-songs' , year = 2006 )

訪問圖表條目

如果chart是ChartData實例，我們可以要求其entries屬性以獲取圖表條目（請參見下）作為列表。

為了方便起見， chart[x]等效於chart.entries[x] ，而ChartData實例是可以的。

圖表輸入屬性

圖表條目（通常為單個軌道）是類型的ChartEntry 。 ChartEntry實例具有以下屬性：

• title - 曲目的標題。
• artist - 藝術家的名字，如Billboard.com上的格式。
• image - 軌道圖像的URL。
• peakPos - 圖表日期以來圖表上的峰值位置為INT（如果圖表不包括此信息， None ）。
• lastPos - 該曲目在上週的圖表上的位置，作為INT（如果圖表不包括此信息， None ）。如果軌道不在前一周的圖表上，則此值為0。
• weeks - 軌道已經或圖表上的幾週數，包括未來的日期（直到當前時間）。
• rank - 曲目在圖表上的當前位置。
• isNew - 曲目是否是圖表的新手。

更多資源

有關其他文檔，請查看文件billboard.py ，或使用Python的交互式help功能。

認為您找到了一個錯誤？在這裡創建一個問題。

貢獻

歡迎拉動請求！請遵守以下樣式指南：

• 我們使用黑色進行格式化。
  • 如果您已經安裝了預要，請運行pre-commit install以安裝黑色運行的預加壓掛鉤。
• 可變名稱應在mixedCase中。

運行測試

要在本地運行測試套件，請安裝鼻子並運行

 nosetests

要在Python 2.7和3.4上本地運行測試套件，請安裝TOX並運行

 tox

用Billboard.py製成

使用Billboard.py的項目和文章：

• “是什麼使音樂流行？”扎克·洛里（Zach Loery）
• “多年來，嘻哈如何變化？”羅漢·克西爾薩加（Rohan Kshirsagar）
• Allen Guo的“ Spotify和Billboard.py”
• Chart_success.py by 3ngthrust
• 詹姆斯·溫澤爾（James Wenzel）
• 傑克·貝克維斯（Jack Beckwith）的“確定每種音樂類型的'生命週期'”
• Karthik Subramanian的“在Spotify API的幫助下，Billboard Hot 100”
• 安迪·弗里德曼（Andy Friedman
• 湯姆·約翰遜（Tom Johnson）的“廣告牌趨勢”
• 卡梅隆·埃澤爾（Cameron Ezell）的“廣告牌圖表”
• “在混音中：最熱門的曲目背後的秘密是什麼？”由Jason Kibozi-Yocka撰寫
• Gabriel P. Oliveira等人的“ Muhsic：具有時間音樂成功信息的開放數據集”。

有一個嗎？提出拉！

依賴性

• 美麗的湯4
• 請求

執照

• 該項目已根據MIT許可獲得許可。
• 廣告牌圖歸Prometheus Global Media LLC擁有。有關更多信息，請參見Billboard.com的使用條款。