Appearance
Artist Tracks
GET /v1/soundcloud/artist/tracks
Fetches tracks/songs for a SoundCloud artist by handle or URL. Returns the artist profile, track list, and pagination info from SoundCloud.
Authentication
All requests require the x-api-key header. Get your key at scrapecreators.com.
Query Parameters
| Name | Type | Required | Description | Example |
|---|---|---|---|---|
handle | string | no | SoundCloud artist handle. If you'd prefer to use the URL instead, you can use the url parameter instead. | kehlanimusic |
url | string | no | SoundCloud artist tracks URL. If you'd prefer to use the handle instead, you can use the handle parameter instead. | https://soundcloud.com/kehlanimusic |
cursor | string | no | Cursor to get more tracks. Get 'cursor' from previous response. | 2026-04-23T00:00:00.000Z,tracks,00000000002319251642 |
Example Request
curl
bash
curl 'https://api.scrapecreators.com/v1/soundcloud/artist/tracks' \
-H 'x-api-key: $SCRAPECREATORS_API_KEY'Node / TypeScript
js
const params = new URLSearchParams({ });
const res = await fetch(`https://api.scrapecreators.com/v1/soundcloud/artist/tracks?${params}`, {
headers: { 'x-api-key': process.env.SCRAPECREATORS_API_KEY }
});
const data = await res.json();
console.log(data);Python
python
import os, requests
r = requests.get(
'https://api.scrapecreators.com/v1/soundcloud/artist/tracks',
headers={'x-api-key': os.environ['SCRAPECREATORS_API_KEY']},
params={},
)
r.raise_for_status()
print(r.json())CLI
bash
scrapecreators soundcloud artist-tracks --helpExample Response
json
{
"success": true,
"credits_remaining": 49997863267,
"tracks": [
{
"artwork_url": "https://i1.sndcdn.com/artworks-RCKR3Fvp7iD1-0-large.jpg",
"caption": null,
"commentable": true,
"comment_count": 19,
"created_at": "2026-04-22T00:39:25Z",
"description": null,
"downloadable": false,
"download_count": 0,
"duration": 179351,
"full_duration": 179305,
"embeddable_by": "all",
"genre": "R&B",
"has_downloads_left": false,
"id": 2306956232,
"kind": "track",
"label_name": "TSNMI / Atlantic",
"last_modified": "2026-05-12T16:04:50Z",
"license": "all-rights-reserved",
"likes_count": 1365,
"permalink": "lights-on-feat-big-sean",
"permalink_url": "https://soundcloud.com/kehlanimusic/lights-on-feat-big-sean",
"playback_count": 28691,
"public": true,
"publisher_metadata": {
"id": 2306956232,
"urn": "soundcloud:tracks:2306956232",
"artist": "Kehlani",
"album_title": "Kehlani",
"contains_music": true,
"upc_or_ean": "075679576071",
"isrc": "USAT22601414",
"explicit": true,
"p_line": "℗ 2026 Atlantic Records Group LLC",
"p_line_for_display": "℗ 2026 Atlantic Records Group LLC",
"c_line": "© 2026 Atlantic Records Group LLC",
"c_line_for_display": "© 2026 Atlantic Records Group LLC",
"release_title": "Lights On (feat. Big Sean)"
},
"purchase_title": null,
"purchase_url": null,
"release_date": "2026-04-23T00:00:00Z",
"reposts_count": 26,
"secret_token": null,
"sharing": "public",
"state": "finished",
"streamable": true,
"tag_list": "",
"title": "Lights On (feat. Big Sean)",
"uri": "https://api.soundcloud.com/tracks/soundcloud%3Atracks%3A2306956232",
"urn": "soundcloud:tracks:2306956232",
"user_id": 51562330,
"visuals": null,
"waveform_url": "https://wave.sndcdn.com/Ht1YwfedlhaJ_m.json",
"display_date": "2026-04-24T04:00:00Z",
"media": {
"transcodings": [
{
"url": "https://api-v2.soundcloud.com/media/soundcloud:tracks:2306956232/647fe3ae-d331-425e-86fa-7c72b98e56f7/stream/cbc-encrypted-hls",
"preset": "aac_160k",
"duration": 179351,
"snipped": false,
"format": {
"protocol": "cbc-encrypted-hls",
"mime_type": "audio/mp4; codecs=\"mp4a.40.2\""
},
"quality": "sq",
"is_legacy_transcoding": false
}
]
},
"station_urn": "soundcloud:system-playlists:track-stations:2306956232",
"station_permalink": "track-stations:2306956232",
"track_authorization": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJnZW8iOiJVUyIsInN1YiI6IiIsInJpZCI6Ijg1MDA3ODQyLTNiZjAtNGZhMC05MTI2LTU2MWRhNDQ0NjM2OCIsImlhdCI6MTc3ODc4NTE1OH0.VDV2Qb0vlomiA2QWvXyPpDKE5JsfNYpmcwkfn47kTcc",
... (truncated)Credits
Most ScrapeCreators endpoints consume 1 credit per successful response. Some heavier endpoints (transcripts, AI-driven enrichment, ad detail lookups) may cost more. Check GET /v1/credit-balance for your remaining balance.
Errors
| Status | Meaning | Action |
|---|---|---|
| 200 | Success. | Use the JSON payload. |
| 400 | Invalid or missing parameter. | Verify required parameters and value format. |
| 401 | Missing or invalid x-api-key. | Pass a valid API key in the header. |
| 402 | Out of credits. | Top up at scrapecreators.com or wait for plan reset. |
| 404 | Resource not found or private. | Confirm the handle, URL, or id and that the resource is public. |
| 429 | Rate limited. | Backoff and retry with exponential delay. |
| 500 | Server error or upstream platform failure. | Retry with backoff; report persistent errors to support. |