Skip to main content

Python wrapper for the internal v2 SoundCloud API.Does not require an API key.

Project description

soundcloud.py

Tests Coverage Status Supported Python Versions Version License Monthly Downloads

Python wrapper for some of the internal v2 SoundCloud API (read/GET only methods). Does not require an API key.

NOTE: This is NOT the official SoundCloud developer API

SoundCloud is not accepting any more application registration requests ^1 so I made this library so developers can use SoundCloud's internal API for their projects.

Documentation

https://7x11x13.xyz/soundcloud.py

Installation

pip install soundcloud-v2

Example

from soundcloud import SoundCloud

sc = SoundCloud(auth_token="auth_token")
assert sc.is_client_id_valid()
assert sc.is_auth_token_valid()
me = sc.get_user_by_username("7x11x13")
assert me.permalink == "7x11x13"

Notes on auth_token

Some methods require authentication in the form of an OAuth2 access token. You can find your token in your browser cookies for SoundCloud under the name "oauth_token". A new token will be generated each time you log out and log back in.

Notes on **kwargs

All API methods have a **kwargs argument which you can use to pass extra, undocumented arguments to the SoundCloud v2 API in case I missed some parameter which you find useful. If this is the case, feel free to create an issue or pull request to document the missing argument.

License

MIT

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-v2-1.5.4.tar.gz (15.9 kB view hashes)

Uploaded Source

Built Distribution

soundcloud_v2-1.5.4-py3-none-any.whl (19.9 kB view hashes)

Uploaded Python 3

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