soundcloud-v2

What it is and what it does

soundcloud-v2 is a Python client for SoundCloud's undocumented internal v2 API, designed for developers who need programmatic access to SoundCloud data without an official API key. It wraps GET-only endpoints and provides methods to fetch user profiles, tracks, playlists, and other metadata. The library requires an OAuth2 access token (extracted from your browser's SoundCloud session cookies) for authenticated operations, though some read-only methods may work without authentication.

The package targets a gap left by SoundCloud's closure of official API registrations; it trades official support for practical access to public SoundCloud data. It depends on dacite for data deserialization, python-dateutil for timestamp handling, and curl_cffi for HTTP requests. The maintainer notes that undocumented API parameters can be passed via **kwargs, making it somewhat resilient to API changes.

Use it for:

• Fetch user profiles and metadata from SoundCloud by username or ID for research or archival.
• Retrieve track information, including duration, play count, and description, without official API access.
• Build a personal SoundCloud library manager or playlist analyzer using internal API endpoints.
• Scrape public SoundCloud data for music recommendation or discovery applications.
• Monitor or log SoundCloud activity for specific users or tracks over time.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

A Python wrapper for SoundCloud's internal v2 API that enables read-only access to SoundCloud data without requiring an official API key.

Yes, if you need SoundCloud data access and cannot use the official API. The package is actively maintained, has no known vulnerabilities, and carries a permissive license. However, be aware that it relies on SoundCloud's undocumented internal API, which could change or be blocked at any time without notice—use it for non-critical applications or with fallback strategies.

Install

soundcloud-v2 on PyPI

pip install soundcloud-v2

uv add soundcloud-v2

poetry add soundcloud-v2

Installing soundcloud-v2

Before you install

Low friction to install; the package is actively maintained with a recent release and supports Python 3.8 through 3.12. Three lightweight runtime dependencies (dacite, python-dateutil, curl_cffi) are standard libraries with minimal overhead.

License in practice

MIT license permits unrestricted use, modification, and distribution with minimal restrictions, making it suitable for both open-source and commercial projects.

Quickstart

pip install soundcloud-v2

from soundcloud import SoundCloud

sc = SoundCloud(auth_token="your_oauth_token")
user = sc.get_user_by_username("username")

Requires a valid SoundCloud OAuth2 access token (found in browser cookies as 'oauth_token') for authenticated methods; token generation requires an active SoundCloud account.

Verify before relying

• Whether all internal API endpoints remain stable or if SoundCloud actively blocks this wrapper's access.
• Performance characteristics and rate-limiting behavior when making bulk requests.
• Whether the package handles SoundCloud API changes automatically or requires manual updates.

Package facts

Evidence: soundcloud_v2-1.7.0-py3-none-any.whl

Tags

More WWW/HTTP packages