LEGAL DISCLAIMER Technically, the use of this API is against Soundcloud's developer ToS. Use at your own risk.

Soundcloud uses an API for it's web app that is much more powerful than it's current public API (that requires an API key that is not available without an account, ew). I have found this API very helpful for writing scripts (like my scrss, so I thought I'd document it for the likes of you. Gross little script goblin.

NOTE: Unless otherwise specified, all these queries require a client_id field to be allowed access to the API. If you don't know how to get this, scrss has code to automatically get this information. I'll leave to figure out how to adapt such code to your project.

DOUBLE NOTE: All responses to API queries in this specification are application/json.

Searching

---

This endpoint is for outputting search suggestions.

q REQUIRED used for your search query. Standard % escaping in a URL is supported.

{
   "collection": [
      {
         "output": "[suggested_search_query]",
         "query": "[suggested_search_query]"
      },
      [8 more times]
   ]
}

This endpoint is for detailed searching.

q REQUIRED used for your search query. Standard % escapin in a URL is supported.
limit used to specify how many entries you want. Defaults to 10 if not supplied.

Responses are encapsulated in a "collection": array, and take the form of either artist entries or song entries.

Homepage Music

---

Soundcloud's homepage (if you are not logged in) displays recommended music. Right now, the majority of it is Lil Uzi Vert. Intentional or not, music here proports to be popular among Soundcloud users.

limit used to specify how many entries you want. Defaults to 10 if not supplied.

Responses are encapsulated in a "collection": array, and take the form of song entries.