README.md

SoundCld

Python API handler for the SoundCloud Internal V2 API, allowing interaction without an API key.

Table of Contents

• Installation
• Usage
• Specifications
• Authentication
• License

Installation:

Global Installation

$ git clone https://github.com/faridrasidov/soundcld
$ cd soundcld
$ pip install .

Virtual Environment

$ git clone https://github.com/faridrasidov/soundcld
$ cd soundcld
$ path/to/your/venv/pip install .

Usage

from soundcld import SoundCloud

sc = SoundCloud(auth=False, auto_id_gen=False)
assert sc.is_client_id_valid()
search = sc.get_search_all("GRXGVR")
for item in search:
    print(item.permalink, item.kind)

Specifications

• You Can Change Your Profile Info
• 45 Get Api Requests Has Been Handled.(Some Of Them Require Auth)
• 7 Put Api Requests hs Been Handled. (All Of Them Require Auth)
• 1 Post Api Requests hs Been Handled. (All Of Them Require Auth)
• 2 Delete Api Requests hs Been Handled. (All Of Them Require Auth)
• Last Valid Generated ID's Automatically Added To 'data.json' File To improve Api Speed.

Authentication

Notes about auth:

Some methods require authentication. If you want to use them, you should get the values written at the bottom from your cookies and put them in file which is in package folder ("soundcloud") named cookies.json. You will also need to change your "client_id" in data.json file in that folder.

Save Them Into:

package_root/soundcld/

cookies.json:

{
  "moe_uuid": "<moe_uuid>",
  "oauth_token": "<oauth_token>",
  "sc_anonymous_id": "<sc_anonymous_id>",
  "datadome": "<datadome>"
}

data.json (this file automatically generates when you get instance):

{
  "user_id": "<user_id>",
  "client_id": "<client_id>",
  "app_version": "<app_version>"
}

License

Soundcld source code is licensed under the terms of the Boost Software License. See LICENSE for more information.