// Integrates applications with the SoundCloud HTTP API using OAuth 2.1, OpenAPI, and developer docs. Use when building SoundCloud API clients, auth flows, uploads, playback, pagination, or debugging API errors.
| name | soundcloud-api-integration |
| description | Integrates applications with the SoundCloud HTTP API using OAuth 2.1, OpenAPI, and developer docs. Use when building SoundCloud API clients, auth flows, uploads, playback, pagination, or debugging API errors. |
Use these; do not invent endpoints or headers:
| Resource | URL |
|---|---|
| OpenAPI JSON | https://developers.soundcloud.com/docs/api/explorer/api.json |
| API Explorer | https://developers.soundcloud.com/docs/api/explorer/open-api |
| API Guide | https://developers.soundcloud.com/docs/api/guide |
| Register app | https://developers.soundcloud.com/docs/api/register-app |
| LLM context | https://developers.soundcloud.com/docs/llm-context |
| Building with AI | https://developers.soundcloud.com/docs/building-with-ai |
https://api.soundcloud.com — token host: https://secure.soundcloud.comapi.soundcloud.com/oauth2/token.Authorization: OAuth <access_token> unless the OpenAPI operation specifies otherwise.soundcloud:users:948745750, soundcloud:tracks:308946187). Numeric ids are deprecated.refresh_token grant instead of repeated client_credentials exchanges.linked_partitioning=true and follow next_href until absent./tracks/{track_urn}/streams (not legacy /stream). Check access: playable, preview, blocked.429 (including play-stream quota: 15k / 24h per client_id).client_id, client_secret, or tokens — use env vars or a secrets manager.| Flow | Use when |
|---|---|
| Authorization Code + PKCE | User-delegated access (/me, uploads, private content) |
| Client Credentials | Public resources only (search, resolve, public playback) |
curl -X GET "https://api.soundcloud.com/ENDPOINT" \
-H "Authorization: OAuth ACCESS_TOKEN" \
-H "accept: application/json; charset=utf-8"
curl -X POST "https://secure.soundcloud.com/oauth/token" \
-H "accept: application/json; charset=utf-8" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Basic BASE64_CLIENT_ID_SECRET" \
--data-urlencode "grant_type=client_credentials"
401 — missing or invalid token429 — rate limited; exponential backoffImplements SoundCloud OAuth 2.1 flows — Authorization Code with PKCE and Client Credentials — including token refresh and secure credential storage. Use when adding login, obtaining tokens, or fixing 401 auth errors.
Implements SoundCloud discovery endpoints — track search, related tracks, and related artists — with URN path parameters and linked_partitioning pagination. Use when building recommendations, “similar” features, or search UIs.