billboard charts

billboard.py

billboard.pyは、billboard.comの音楽チャートにアクセスするためのPython APIです。

インストール

PIPでインストール：

 pip install billboard.py

または、このリポジトリをクローンして、 python setup.py installを実行します。

クイックスタート

ビルボードチャートをダウンロードするには、 ChartData()コンストラクターを使用します。

現在のホット100チャートをフェッチしましょう。

 >> > 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を使用するプロジェクトと記事：

• 「何が音楽をポップにしているのですか？」ザック・ロリーによって
• 「ヒップホップは長年にわたってどのように変化しましたか？」 Rohan Kshirsagarによる
• Allen Guoによる「SpotifyとBillboard.py」
• chart_success.py by 3ngthrust
• ジェームズ・ウェンツェル @ポリグラフによる「トップビルボードストリーク」と「ドレイクのホット100ストリーク」
• Jack Beckwith @ Data Faceによる「各音楽ジャンルの「ライフサイクル」を決定する」
• Karthik Subramanianの「Spotify APIの助けを借りて、ビルボードHot 100をスプランスする」
• アンディ・フリードマンによる「70年代および80年代のビルボードR＆Bチャートの動きの予測」
• トム・ジョンソンによる「ビルボードのトレンド」
• Cameron Ezellによる「ビルボードチャートAlexa Skill」
• 「ミックス：最もホットなトラックの背後にある秘密の式は何ですか？」ジェイソン・キボジ・ヨッカ
• 「Muhsic：一時的な音楽成功情報を備えたオープンデータセット」Gabriel P. Oliveira et al。

追加がありますか？プルリクエストを行います！

依存関係

• 美しいスープ4
• リクエスト

ライセンス

• このプロジェクトは、MITライセンスの下でライセンスされています。
• ビルボードチャートは、Prometheus Global Media LLCが所有しています。詳細については、Billboard.comの利用規約を参照してください。