SoundCloud Profile API
Resolve a public SoundCloud handle to a profile card — display name, bio, avatar, location, verification, and counts — without a SoundCloud developer app.
GET /v1/soundcloud/profiles/{handle}1 credit per successful request.
About this endpoint
`GET /v1/soundcloud/profiles/{handle}` is the dedicated profile lookup. Pass the public username from `soundcloud.com/{handle}` (with or without a leading `@`), send `x-api-key`, and read `data.lookupStatus` before you write a row. On `found`, the profile card carries display name, bio, avatar and banner, city and country when present, verification, and counts for followers, tracks, playlists, and likes.
Credit pricing for this operation comes from the API registry and appears on this page; `meta.creditsCharged` is the billing source of truth. For track uploads under the same handle, use the separate profile-tracks list route. Single-track detail by share URL is a third SoundCloud operation.
SoundCloud Profile API FAQ
How do I fetch a SoundCloud profile by handle?
Call GET /v1/soundcloud/profiles/{handle} with your Social Fetch API key in the x-api-key header. The path accepts the public username from soundcloud.com/{handle}, with or without a leading @. See the API docs for parameters and examples.
How many credits does a SoundCloud profile lookup cost?
Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged — that field is the billing source of truth.
What does lookupStatus mean?
found means the profile card is populated. not_found means the handle did not resolve to a public profile. Always branch on lookupStatus before treating the payload as a found card. HTTP 200 only means the request finished.
Do I need a SoundCloud developer app or OAuth?
No. Social Fetch authenticates with your Social Fetch API key only. SoundCloud's official developer API has been closed to new applications for years — these public lookups do not depend on getting approved.
What fields are in the SoundCloud profile card?
On found: display name, bio, avatar and banner, city and country when present, verification, and counts for followers, tracks, playlists, and likes. Exact fields are on the API docs page for this route.
Is this the same as listing profile tracks?
No. This endpoint returns the profile card only. To page track uploads for a handle, use GET /v1/soundcloud/profiles/{handle}/tracks. For one track by share URL, use GET /v1/soundcloud/tracks?url=.