soundcloud-charts-api

soundcloud-charts-api

A python wrapper for the Soundcloud Charts API.

NOTE: This is a wrapper for a public, undocumented API.

Getting Started

Documentation

Find full documentation of the project here: https://soundcloud-charts-api.readthedocs.io

Dependencies

• Requests

Installing

python setup.py install

or

pip install soundcloud-charts-api

Example

from soundcloudcharts import SoundCloudCharts

sc = SoundCloudCharts()
chart_data = sc.get_chart(region='us', limit=10)

for i, item in enumerate(chart_data['collection']):
    print('{0}: {1} - {2}'.format(str(i+1), 
                                  item['track']['user']['username'], 
                                  item['track']['title']))

API Parameters

KIND:

• top
• trending (New & Hot)

GENRE:

• all-music
• all-audio
• alternativerock
• ambient
• classical
• country
• danceedm
• dancehall
• deephouse
• disco
• drumbass
• dubstep
• electronic
• folksingersongwriter
• hiphoprap
• house
• indie
• jazzblues
• latin
• metal
• piano
• pop
• rbsoul
• reggae
• reggaeton
• rock
• soundtrack
• techno
• trance
• trap
• triphop
• world

REGION:

• au (Australia)
• ca (Canada)
• fr (France)
• de (Germany)
• ie (Ireland)
• nl (Netherlands)
• nz (New Zealand)
• gb (Great Britain)
• us (United States)

Versioning

• v1.0.1 - Initial Release - 08/18/2019
• v1.0.2 - Fixed bug when using proxies - 08/19/2019
• v1.0.3 - Updated file where key is found - 01/01/2020
• v1.0.4 - Update to automatically find file with key - 03/09/2020

Authors

• Matt Palazzolo - GitHub Profile

License

This project is licensed under the MIT License - see the LICENSE.txt file for details