// 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.
Implements 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.
| 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 backoff