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的使用条款。