SoundCloud API endpoint
Returns a SoundCloud user or artist profile for a full profile `url` such as `https://soundcloud.com/artist`. Fields are username, full name, bio, avatar, city, country, verified status, and counts of followers, followings, tracks, playlists and likes. A URL for a track or other entity returns 400; an unresolvable URL returns 404.
/soundcloud/profileReturns one user/artist's profile: bio, avatar, followers/followings/ track/playlist/likes counts, and verified status. Public data, sourced from SoundCloud's own JSON API.
Query parameters:
url (required) — a full soundcloud.com user/artist profile URL, e.g.
https://soundcloud.com/artist.Notable response behavior:
track_count/playlist_count are the profile owner's own uploads,
not likes or reposts.url is resolved server-side against SoundCloud's own resolve
endpoint — it must be a user/artist profile URL. A URL that resolves
to a different entity type (e.g. a track) returns 400.404. A missing url returns 400
before any upstream request is made.| Field | In the sample | Value in the sample |
|---|---|---|
| id | Has a value | |
| username | Has a value | |
| permalink | Has a value | |
| permalink_url | Has a value | soundcloud.com |
| avatar_url | Has a value | i1.sndcdn.com |
| description | Has a value | |
| followers_count | Has a value | 256,062 |
| followings_count | Has a value | 634 |
| track_count | Has a value | 733 |
| playlist_count | Has a value | 27 |
| likes_count | Has a value | 1,031 |
| verified | Has a value | true |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| url | string | Yes | Full soundcloud.com user/artist profile URL | https://soundcloud.com/lofi_girl | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/soundcloud/profile?url=https%3A%2F%2Fsoundcloud.com%2Flofi_girl" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"id": 144868900,
"username": "Lofi Girl",
"permalink": "lofi_girl",
"permalink_url": "https://soundcloud.com/lofi_girl",
"avatar_url": "https://i1.sndcdn.com/avatars-8D5zoj5ySzRF0jHc-oPZwDg-large.jpg",
"description": "study, chill, sleep, repeat.",
"followers_count": 255531,
"followings_count": 634,
"track_count": 712,
"playlist_count": 27,
"likes_count": 1032,
"verified": true
}
}Request schema
No body schema
Response schema
#/definitions/soundcloud.profileResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | soundcloud.Profile | No | ||||
| data.avatar_url | string | No | ||||
| data.city | string | No | ||||
| data.country_code | string | No | US | |||
| data.description | string | No | ||||
| data.followers_count | integer | No | 255531 | |||
| data.followings_count | integer | No | 634 | |||
| data.full_name | string | No | ||||
| data.id | integer | No | ||||
| data.likes_count | integer | No | 1032 | |||
| data.permalink | string | No | ||||
| data.permalink_url | string | No | ||||
| data.playlist_count | integer | No | 27 | |||
| data.track_count | integer | No | 712 | |||
| data.username | string | No | ||||
| data.verified | boolean | No | ||||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 429 | Too Many Requests | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/soundcloud/profile?url=https%3A%2F%2Fsoundcloud.com%2Flofi_girl" \
-H "x-api-key: $CRAWLORA_API_KEY"