Skip to main content

A python wrapper for the Soundcloud Chart API

Project description

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

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

License

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

soundcloud-charts-api-1.0.4.tar.gz (4.6 kB view details)

Uploaded Source

File details

Details for the file soundcloud-charts-api-1.0.4.tar.gz.

File metadata

  • Download URL: soundcloud-charts-api-1.0.4.tar.gz
  • Upload date:
  • Size: 4.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/40.8.0 requests-toolbelt/0.9.1 tqdm/4.34.0 CPython/3.6.8

File hashes

Hashes for soundcloud-charts-api-1.0.4.tar.gz
Algorithm Hash digest
SHA256 aff866b6863f10ce274951fe5d6623004fed74e6b38d6e0b3931092f67e5c33f
MD5 20b9a6c1f175c154eb550935c3d97743
BLAKE2b-256 880a0c316ce16bbbace77fb8dfd6fa7e66e7d73a45e2d739886dc0c5c7b960f0

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page