SoundCloud API endpoint
Searches SoundCloud tracks for `query`, in SoundCloud's default relevance order. `limit` defaults to 20 and is capped at 50. Each track has its title, artwork, genre, tags, `duration_ms`, play, like, comment and repost counts, and uploader details including follower count and verified status.
/soundcloud/searchReturns tracks matching a query: title, artwork, description, genre, tags, playback/likes/comment/repost counts, and uploader. Public data, sourced from SoundCloud's own JSON API.
Query parameters:
query (required) — search text.limit (optional) — number of tracks to return. Defaults to 20,
clamped to a maximum of 50.Notable response behavior:
tracks is ordered by SoundCloud's own default relevance sort.duration_ms is the track's length in milliseconds.query returns 400 before any upstream request is made.| Field | Filled in, of 20 checked | Values in the sample |
|---|---|---|
| id | 20 | |
| title | 20 | |
| permalink_url | 20 | soundcloud.com |
| artwork_url | 20 | i1.sndcdn.com |
| description | 17 | median 426 characters |
| genre | 17 | |
| tag_list | 13 | |
| duration_ms | 20 | 63,876 to 7,200,255, median 238,544 |
| playback_count | 20 | 0 to 4,975,252, median 638,286 |
| likes_count | 20 | 0 to 94,482, median 8,840 |
| comment_count | 20 | 0 to 4,841, median 390 |
| reposts_count | 20 | 0 to 2,223, median 182 |
| created_at | 20 | 2018-01-25 to 2026-09-21 |
| public | 20 | true in 20 of 20 |
| streamable | 20 | true in 20 of 20 |
| uploader | 20 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| query | string | Yes | Search text | lofi hip hop | |
| limit | integer | No | Number of tracks to return (default 20, max 50) | 20 | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/soundcloud/search?query=lofi+hip+hop&limit=10" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"query": "lofi hip hop",
"count": 20,
"tracks": [
{
"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",
"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.searchResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | soundcloud.SearchResponse | No | ||||
| data.count | integer | No | 20 | |||
| data.query | string | No | ||||
| data.tracks | array | No | Track record, 25 fields: artwork_url, comment_count, created_at, description, duration_ms, genre, id, likes_count, permalink_url, playback_count, public, reposts_count and 4 more. Described under SoundCloud track API. | |||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/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/search?query=lofi+hip+hop&limit=10" \
-H "x-api-key: $CRAWLORA_API_KEY"