Skip to main content

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

  1. https://docs.google.com/forms/d/e/1FAIpQLSfNxc82RJuzC0DnISat7n4H-G7IsPQIdaMpe202iiHZEoso9w/closedform ↩

Metadata

Release files for soundcloud-v2 1.7.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for soundcloud-v2 1.7.0
File Size Uploaded
soundcloud_v2-1.7.0.tar.gz 17.5 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for soundcloud-v2 1.7.0
File Interpreter ABI Platform
soundcloud_v2-1.7.0-py3-none-any.whl Python 3 none any Details

Total release size: 38.2 kB

Release files / soundcloud_v2-1.7.0.tar.gz

Download URL soundcloud_v2-1.7.0.tar.gz
Size 17.5 kB
Tags Source
SHA-256 checksum
How to use checksums
ce6789f5d7966c38939d52c7fcb326197592c06d68d5585859fa0a4f98c095c9
BLAKE2b-256 checksum
How to use checksums
f187abf8b9f9075c908b4433ee31ca856f9be068dc4315a71e05e9a384ba3a1f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.12

Release files / soundcloud_v2-1.7.0-py3-none-any.whl

Download URL soundcloud_v2-1.7.0-py3-none-any.whl
Size 20.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
ff7e37ed65f655f7d66f9819b266915499489ac640a58c3fb173101d7eebeb2b
BLAKE2b-256 checksum
How to use checksums
bdcc77c1d8edd12770ce643f85c0050045ec7bd0d8b440447699f0e863fc136a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.12
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page