SoundCloud API endpoint
Returns one track's full metadata: title, artwork, description, genre, tags, playback/likes/comment/repost counts, and uploader. Public data sourced from SoundCloud's own JSON API.
/soundcloud/trackQuery parameters:
url (required) — a full soundcloud.com track URL (a track's
permalink_url, e.g. from a /soundcloud/search
result's permalink_url field).Notable response behavior:
url is resolved server-side against SoundCloud's own resolve
endpoint — it must be a track URL. A URL that resolves to a different
entity type (e.g. a playlist) 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 | |
| title | Has a value | |
| permalink_url | Has a value | soundcloud.com |
| artwork_url | Has a value | i1.sndcdn.com |
| description | Has a value | 2,216 characters |
| genre | Has a value | |
| tag_list | Has a value | |
| duration_ms | Has a value | 7,200,255 |
| playback_count | Has a value | 4,848,455 |
| likes_count | Has a value | 94,482 |
| comment_count | Has a value | 4,841 |
| reposts_count | Has a value | 2,223 |
| created_at | Has a value | 2018-03-22 |
| public | Has a value | true |
| streamable | Has a value | true |
| uploader.id | Has a value | |
| uploader.username | Has a value | |
| uploader.permalink | Has a value | |
| uploader.permalink_url | Has a value | soundcloud.com |
| uploader.avatar_url | Has a value | i1.sndcdn.com |
| uploader.city | Has a value | |
| uploader.followers_count | Has a value | 4,140 |
| uploader.track_count | Has a value | 2 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| url | string | Yes | Full soundcloud.com track URL (a track's permalink_url) | https://soundcloud.com/lofi_girl/4-am-studysession | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/soundcloud/track?url=https%3A%2F%2Fsoundcloud.com%2Flofi_girl%2F4-am-studysession" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"id": 417474360,
"title": "Chill Study Beats - Lofi Hip Hop Mix [2018]",
"permalink_url": "https://soundcloud.com/nigeldelviero/chill-study-beats-lofi-hip-hop-mix-2018",
"artwork_url": "https://i1.sndcdn.com/artworks-000321524016-jw118f-large.jpg",
"description": "Enjoy 🔊\nFull tracklist...",
"genre": "Hip-hop & Rap",
"tag_list": "Lo-Fi Relax Chill",
"duration_ms": 7200255,
"playback_count": 4810593,
"likes_count": 93943,
"comment_count": 4835,
"reposts_count": 2218,
"created_at": "2018-03-22T08:35:48Z",
"public": true,
"streamable": true,
"uploader": {
"id": 154582242,
"username": "nigeldelviero",
"permalink": "nigeldelviero",
"permalink_url": "https://soundcloud.com/nigeldelviero",
"city": "Jakarta",
"followers_count": 4113,
"track_count": 2
}
}
}Request schema
No body schema
Response schema
#/definitions/soundcloud.trackResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | soundcloud.Track | No | ||||
| data.artwork_url | string | No | ||||
| data.comment_count | integer | No | 57 | |||
| data.created_at | string | No | 2021-06-14T15:40:10Z | |||
| data.description | string | No | ||||
| data.duration_ms | integer | No | 165218 | |||
| data.genre | string | No | ||||
| data.id | integer | No | ||||
| data.likes_count | integer | No | 10101 | |||
| data.permalink_url | string | No | ||||
| data.playback_count | integer | No | 2593224 | |||
| data.public | boolean | No | true | |||
| data.reposts_count | integer | No | 196 | |||
| data.streamable | boolean | No | true | |||
| data.tag_list | string | No | ||||
| data.title | string | No | ||||
| data.uploader | soundcloud.Uploader | No | ||||
| data.uploader.avatar_url | string | No | ||||
| data.uploader.city | string | No | ||||
| data.uploader.followers_count | integer | No | 220 | |||
| data.uploader.id | integer | No | ||||
| data.uploader.permalink | string | No | ||||
| data.uploader.permalink_url | string | No | ||||
| data.uploader.track_count | integer | No | 12 | |||
| data.uploader.username | string | No | ||||
| data.uploader.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/track?url=https%3A%2F%2Fsoundcloud.com%2Flofi_girl%2F4-am-studysession" \
-H "x-api-key: $CRAWLORA_API_KEY"