billboard charts

Billboard.py

Billboard.py 는 Billboard.com에서 음악 차트에 액세스하기위한 Python API입니다.

설치

PIP로 설치 :

 pip install billboard.py

또는이 저장소를 복제하고 python setup.py install 실행하십시오.

QuickStart

빌보드 차트를 다운로드하려면 ChartData() 생성자를 사용합니다.

현재 HOT 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 인스턴스는 반복 가능합니다.

차트 항목 속성

차트 항목 (일반적으로 단일 트랙)은 Type 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 and Billboard.py"
• 3ngthrust의 Chart_success.py
• "Top Billboard Streaks"및 "Drake 's Hot-100 Streak"의 James Wenzel @ Polygraph
• Jack Beckwith @ The Data Face의 "각 음악 장르의 '수명주기'결정"
• Karthik Subramanian의 "Spotify API의 도움으로 Billboard Hot 100의 스 플랭킹"
• Andy Friedman의 "70 년대 및 80 년대 빌보드 R & B 차트의 움직임 예측"
• Tom Johnson의 "Billboard Trends"
• Cameron Ezell의 "Billboard 차트 Alexa Skill"
• "믹스에서 : 가장 인기있는 트랙의 비밀 공식은 무엇입니까?" Jason Kibozi-Yocka
• Gabriel P. Oliveira et al.

추가가 있습니까? 풀 요청하십시오!

의존성

• 아름다운 수프 4
• 요청

특허

• 이 프로젝트는 MIT 라이센스에 따라 라이센스가 부여됩니다.
• 빌보드 차트는 Prometheus Global Media LLC가 소유하고 있습니다. 자세한 내용은 Billboard.com의 이용 약관을 참조하십시오.