soundcloud-v2

library1.7.0pypypi✓ verified 83d ago

Unofficial Python library for the internal SoundCloud v2 API. No API key required. Currently at version 1.7.0, supporting Python >=3.8. Actively maintained but has undergone breaking changes in the past.

analytics

pip install soundcloud-v2

github ↗homepage ↗

INSTALL

IMPORT

SIG · SOUNDCLOUD-V2

soundcloud-v2

analyticspythonv1.7.0

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

SoundCloud

✓ from soundcloud import SoundCloud

✗ from soundcloud_v2 import SoundCloud

Module name omits the v2 suffix; wrong import causes ModuleNotFoundError

Initialize the client without any keys and fetch a track by ID.

import os from soundcloud import SoundCloud client = SoundCloud() # No auth required, but you can set proxy or user-agent if needed # Fetch a track track = client.get_track(123456789) print(track.title)

Debug

Known issues

breakingThe client was renamed from `Client` to `SoundCloud` in v1.0.0. All code using `from soundcloud import Client` will break.

fix

Change import to `from soundcloud import SoundCloud` and use `SoundCloud()` instead of `Client()`.

affects: <1.0.0

gotchaThe API is based on SoundCloud's internal undocumented endpoints. Rate limits and endpoint changes can occur without notice. The library may stop working at any time.

fix

Monitor the library's GitHub for updates; consider adding retry logic or a fallback.

affects: all

gotchaSome methods (e.g., `get_playlist`, `get_user`) may return inconsistent data or raise `soundcloud.exceptions.APIException` if the resource is private or deleted. Always handle exceptions.

fix

Wrap calls in try/except blocks and check response status.

affects: all

deprecatedThe `search` method signatures changed between versions. Using the old positional arguments may fail.

fix

Use keyword arguments: `client.search(tracks={'q': 'query'})` instead of `client.search('query')`.

affects: <1.5.0

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'soundcloud_v2'

Incorrect import path: the package name is `soundcloud-v2` on PyPI, but the module to import is `soundcloud` (no v2 suffix).

fix

Use `from soundcloud import SoundCloud`.

AttributeError: module 'soundcloud' has no attribute 'Client'

The class was renamed from `Client` to `SoundCloud` in v1.0.0.

fix

Replace `Client()` with `SoundCloud()` and `from soundcloud import SoundCloud`.

soundcloud.exceptions.APIException: 404 Not Found

The requested resource (track, playlist, etc.) does not exist or is private. SoundCloud v2 API may also return 404 for incomplete IDs.

fix

Verify the resource ID exists and is public. Wrap calls in try/except: try: track = client.get_track(id) except APIException: pass

Upgrade

Version history

1.7.0latest on PyPI · released Apr 26, 2026

Audit

Dependencies

requestsrequiredHTTP client for API calls

Agent activity

31 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/7x11x13/soundcloud.py ↗

homepagehttps://github.com/7x11x13/soundcloud.py ↗