> ## Documentation Index > Fetch the complete documentation index at: https://docs.scraperize.com/llms.txt > Use this file to discover all available pages before exploring further. # Artist tracks > Returns a SoundCloud artist's tracks, newest first, 20 per page: each with its title, link, genre, tags, full-length duration, plays, likes, reposts and comments, release and upload dates, artwork, label, ISRC and album, whether only a 30-second preview plays, the waveform and its stream variants (transcodings). Pass the returned `cursor` back (with the same artist) for the next page — up to page 25. Only publicly available data is returned. > [!NOTE] > > **Cost: 1 credit** per successful request. Errors and cache hits (`cache_max_age`) are free. > [accordion] Copy for AI assistant > > Paste this into ChatGPT, Claude or your coding assistant to generate working code for this endpoint (use the copy button). > > ```text Prompt > I want to make an API call to /v1/soundcloud/artist/tracks. Here are the details: > > Endpoint: GET https://api.scraperize.com/v1/soundcloud/artist/tracks > Description: Returns a SoundCloud artist's tracks, newest first, 20 per page: each with its title, link, genre, tags, full-length duration, plays, likes, reposts and comments, release and upload dates, artwork, label, ISRC and album, whether only a 30-second preview plays, the waveform and its stream variants (transcodings). Pass the returned `cursor` back (with the same artist) for the next page — up to page 25. Only publicly available data is returned. > > Required Headers: > - x-api-key: Your API key > > Parameters: > - handle (string): The artist's handle (the name in their link), e.g. `billieeilish`. Required unless `url` is given. > - url (string): The artist's link, e.g. `https://soundcloud.com/billieeilish/tracks`. Required unless `handle` is given. > - cursor (string): The `cursor` from the previous page, to get the next one. Omit for the first page. > - cache_max_age (select): Optional. Return a cached result if one this age or newer exists — served for **0 credits** with `meta.cached=true` and `meta.cachedAt`. Otherwise a fresh scrape runs (**1 credit**) and refreshes the cache. Omit to always scrape fresh. > > Example Response: > { > "data": { > "artist": { > "id": "18604897", > "handle": "odesza", > "name": "ODESZA", > "url": "https://soundcloud.com/odesza", > "trackCount": 270 > }, > "page": 1, > "tracks": [ > { > "id": "2068581260", > "urn": "soundcloud:tracks:2068581260", > "title": "Muzak Kier Hymn (ODESZA Severance Remix)", > "url": "https://soundcloud.com/odesza/muzak-kier-hymn-odesza", > "description": "'Music To Refine To: A Remix Companion to Severance', out now on Foreign Family Collective: https://odesza.lnk.to/severance-rmxSo\n\nFollow ODESZA -\nSpotify: http…", > "genre": "Electronic", > "tags": [], > "artworkUrl": "https://i1.sndcdn.com/artworks-IB24kQAtoktZ-0-large.png", > "waveformUrl": "https://wave.sndcdn.com/UI8SPsiXjgbN_m.json", > "durationMs": 270890, > "isPreviewOnly": false, > "plays": 15706, > "likes": 366, > "reposts": 41, > "comments": 8, > "downloads": 0, > "createdAt": "2025-04-01T18:51:35Z", > "releaseDate": "2025-04-04T00:00:00Z", > "displayDate": "2025-04-04T00:00:00Z", > "lastModified": "2025-04-03T15:29:16Z", > "isDownloadable": false, > "isCommentable": true, > "isStreamable": true, > "isPublic": true, > "license": "all-rights-reserved", > "labelName": "Foreign Family Collective", > "purchase": { > "title": null, > "url": "https://odesza.lnk.to/severance-rmxSo" > }, > "policy": "ALLOW", > "monetizationModel": "NOT_APPLICABLE", > "embeddableBy": "all", > "publisher": { > "artist": "ODESZA and Theodore Shapiro", > "albumTitle": "Music To Refine To: A Remix Companion to Severance", > "releaseTitle": "Muzak Kier Hymn (ODESZA Severance Remix)", > "isrc": "GBCFB2500169", > "upc": "5054429203936", > "isExplicit": false, > "pLine": "℗ 2025 FIFTH SEASON LLC and Apple Video Programming LLC, under license to Foreign Family Collective. All Rights Reserved.", > "cLine": "© 2025 FIFTH SEASON LLC and Apple Video Programming LLC, under license to Foreign Family Collective. All Rights Reserved.", > "containsMusic": true > }, > "transcodings": [ > { > "url": "https://api-v2.soundcloud.com/media/soundcloud:tracks:2068581260/22c56881-382a-4ea5-b53a-a9c761bd7f87/stream/cbc-encrypted-hls", > "preset": "aac_160k", > "protocol": "cbc-encrypted-hls", > "mimeType": "audio/mp4; codecs=\"mp4a.40.2\"", > "quality": "sq", > "isSnippet": false, > "durationMs": 270893, > "isLegacy": false > } > ], > "artist": { > "id": "18604897", > "handle": "odesza", > "url": "https://soundcloud.com/odesza", > "name": "ODESZA", > "avatarUrl": "https://i1.sndcdn.com/avatars-9N0KOFupZRs2l2QQ-seYNnA-large.jpg", > "isVerified": true, > "followers": 783898 > } > } > ], > "count": 20, > "cursor": "eyJoIjoib2Rlc3phIiwicCI6Mn0", > "hasMore": true, > "fetchedAt": "2026-11-11T09:06:12.909Z" > }, > "meta": { > "requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f", > "creditsCharged": 1, > "creditsRemaining": 4999, > "cached": false > } > } > > Please help me write code in my preferred programming language to make this API call and handle the response appropriately. Include error handling and best practices. > ``` ## OpenAPI ````yaml /api-reference/openapi.json get /v1/soundcloud/artist/tracks openapi: 3.0.3 info: title: Scraperize API version: 1.0.0 description: >- Extract public data from social media platforms as clean JSON. Endpoints are split by platform and by what they return, e.g. `GET /v1/twitter/tweet`. ## Authentication Send your API key in the `x-api-key` header (or `Authorization: Bearer `). Create keys in your dashboard. ## Credits Each successful live scrape costs **1 credit**. Credits are prepaid and never expire. ## Caching Every endpoint accepts an optional `cache_max_age` (`1d`|`3d`|`7d`|`14d`|`30d`). A cache hit within that window is returned for **0 credits**. ## Responses Success returns `{ "data": …, "meta": { "requestId", … } }`. Errors return `{ "error": { "code", "message", "requestId" } }` with a matching HTTP status. `meta` on a scrape carries `creditsCharged`, `creditsRemaining`, `cached`, and (on a hit) `cachedAt`. ## Rate limits Requests are limited per team per minute; over the limit returns `429` with a `Retry-After` header. servers: - url: https://api.scraperize.com description: Production security: - ApiKeyAuth: [] tags: - name: Twitter description: Twitter / X scraping endpoints - name: Facebook description: Facebook scraping endpoints - name: Linkme description: Linkme (link.me) scraping endpoints - name: Amazon description: Amazon (creator shop / storefront) scraping endpoints - name: Linkbio description: Linkbio (lnk.bio) scraping endpoints - name: Pillar description: Pillar (pillar.io) scraping endpoints - name: Komi description: Komi (komi.io) scraping endpoints - name: Linktree description: Linktree (linktr.ee) scraping endpoints - name: Kick description: Kick (kick.com) scraping endpoints - name: Snapchat description: Snapchat (snapchat.com) scraping endpoints - name: Telegram description: Telegram (t.me) scraping endpoints - name: LinkedIn description: LinkedIn scraping endpoints - name: Twitch description: Twitch scraping endpoints - name: TikTok description: TikTok (tiktok.com) scraping endpoints - name: Instagram description: Instagram scraping endpoints - name: Lagos Life description: Lagos Life scraping endpoints - name: Bluesky description: Bluesky (bsky.app) scraping endpoints - name: Threads description: Threads (threads.com) scraping endpoints - name: Reddit description: Reddit (reddit.com) scraping endpoints - name: Rumble description: Rumble (rumble.com) scraping endpoints - name: SoundCloud description: SoundCloud (soundcloud.com) scraping endpoints - name: Kwai description: Kwai (kwai.com) scraping endpoints - name: Apple Music description: Apple Music (music.apple.com) scraping endpoints - name: Truth Social description: Truth Social (truthsocial.com) scraping endpoints - name: YouTube description: YouTube (youtube.com) scraping endpoints paths: /v1/soundcloud/artist/tracks: get: tags: - SoundCloud summary: Artist tracks description: >- Returns a SoundCloud artist's tracks, newest first, 20 per page: each with its title, link, genre, tags, full-length duration, plays, likes, reposts and comments, release and upload dates, artwork, label, ISRC and album, whether only a 30-second preview plays, the waveform and its stream variants (transcodings). Pass the returned `cursor` back (with the same artist) for the next page — up to page 25. Only publicly available data is returned. parameters: - name: handle in: query required: false description: >- The artist's handle (the name in their link), e.g. `billieeilish`. Required unless `url` is given. schema: type: string example: billieeilish - name: url in: query required: false description: >- The artist's link, e.g. `https://soundcloud.com/billieeilish/tracks`. Required unless `handle` is given. schema: type: string - name: cursor in: query required: false description: >- The `cursor` from the previous page, to get the next one. Omit for the first page. schema: type: string - name: cache_max_age in: query required: false description: >- Optional. Return a cached result if one this age or newer exists — served for **0 credits** with `meta.cached=true` and `meta.cachedAt`. Otherwise a fresh scrape runs (**1 credit**) and refreshes the cache. Omit to always scrape fresh. schema: type: string enum: - 1d - 3d - 7d - 14d - 30d example: 7d responses: '200': description: One page of tracks (empty past the last one). content: application/json: schema: type: object properties: data: type: object meta: type: object description: >- requestId + credit/caching metadata (creditsCharged, creditsRemaining, cached, cachedAt). required: - data - meta example: data: artist: id: '18604897' handle: odesza name: ODESZA url: https://soundcloud.com/odesza trackCount: 270 page: 1 tracks: - id: '2068581260' urn: soundcloud:tracks:2068581260 title: Muzak Kier Hymn (ODESZA Severance Remix) url: https://soundcloud.com/odesza/muzak-kier-hymn-odesza description: >- 'Music To Refine To: A Remix Companion to Severance', out now on Foreign Family Collective: https://odesza.lnk.to/severance-rmxSo Follow ODESZA - Spotify: https://found.ee/odesza-sp Apple Music: https://found.ee/odesza-am Amazon Music: https://found.ee/odesza-aa YouTube: https://found.ee/odesza-yt Bandcamp: https://found.ee/odesza-bc Soundcloud: https://found.ee/odesza-sc Instagram: https://found.ee/odesza-ig Discord: https://found.ee/odesza-dc TikTok: https://found.ee/odesza-tt Facebook: https://found.ee/odesza-fb X (Twitter): https://found.ee/odesza-tw #ODESZA #ForeignFamilyCollective genre: Electronic tags: [] artworkUrl: https://i1.sndcdn.com/artworks-IB24kQAtoktZ-0-large.png waveformUrl: https://wave.sndcdn.com/UI8SPsiXjgbN_m.json durationMs: 270890 isPreviewOnly: false plays: 15706 likes: 366 reposts: 41 comments: 8 downloads: 0 createdAt: '2025-04-01T18:51:35Z' releaseDate: '2025-04-04T00:00:00Z' displayDate: '2025-04-04T00:00:00Z' lastModified: '2025-04-03T15:29:16Z' isDownloadable: false isCommentable: true isStreamable: true isPublic: true license: all-rights-reserved labelName: Foreign Family Collective purchase: title: null url: https://odesza.lnk.to/severance-rmxSo policy: ALLOW monetizationModel: NOT_APPLICABLE embeddableBy: all publisher: artist: ODESZA and Theodore Shapiro albumTitle: 'Music To Refine To: A Remix Companion to Severance' releaseTitle: Muzak Kier Hymn (ODESZA Severance Remix) isrc: GBCFB2500169 upc: '5054429203936' isExplicit: false pLine: >- ℗ 2025 FIFTH SEASON LLC and Apple Video Programming LLC, under license to Foreign Family Collective. All Rights Reserved. cLine: >- © 2025 FIFTH SEASON LLC and Apple Video Programming LLC, under license to Foreign Family Collective. All Rights Reserved. containsMusic: true transcodings: - url: >- https://api-v2.soundcloud.com/media/soundcloud:tracks:2068581260/22c56881-382a-4ea5-b53a-a9c761bd7f87/stream/cbc-encrypted-hls preset: aac_160k protocol: cbc-encrypted-hls mimeType: audio/mp4; codecs="mp4a.40.2" quality: sq isSnippet: false durationMs: 270893 isLegacy: false - url: >- https://api-v2.soundcloud.com/media/soundcloud:tracks:2068581260/22c56881-382a-4ea5-b53a-a9c761bd7f87/stream/ctr-encrypted-hls preset: aac_160k protocol: ctr-encrypted-hls mimeType: audio/mp4; codecs="mp4a.40.2" quality: sq isSnippet: false durationMs: 270893 isLegacy: false - url: >- https://api-v2.soundcloud.com/media/soundcloud:tracks:2068581260/d7c88f88-03f6-428f-b658-e4f51cfd4373/stream/cbc-encrypted-hls preset: aac_96k protocol: cbc-encrypted-hls mimeType: audio/mp4; codecs="mp4a.40.2" quality: lq isSnippet: false durationMs: 270893 isLegacy: false artist: id: '18604897' handle: odesza url: https://soundcloud.com/odesza name: ODESZA avatarUrl: >- https://i1.sndcdn.com/avatars-9N0KOFupZRs2l2QQ-seYNnA-large.jpg isVerified: true followers: 783898 - id: '2068581252' urn: soundcloud:tracks:2068581252 title: Mammalians Nurturable (ODESZA Severance Remix) url: >- https://soundcloud.com/odesza/mammalians-nurturable-odesza description: >- 'Music To Refine To: A Remix Companion to Severance', out now on Foreign Family Collective: https://odesza.lnk.to/severance-rmxSo Follow ODESZA - Spotify: https://found.ee/odesza-sp Apple Music: https://found.ee/odesza-am Amazon Music: https://found.ee/odesza-aa YouTube: https://found.ee/odesza-yt Bandcamp: https://found.ee/odesza-bc Soundcloud: https://found.ee/odesza-sc Instagram: https://found.ee/odesza-ig Discord: https://found.ee/odesza-dc TikTok: https://found.ee/odesza-tt Facebook: https://found.ee/odesza-fb X (Twitter): https://found.ee/odesza-tw #ODESZA #ForeignFamilyCollective genre: Electronic tags: [] artworkUrl: https://i1.sndcdn.com/artworks-5pJaoDZ6eLSl-0-large.png waveformUrl: https://wave.sndcdn.com/5VUOehY9miPe_m.json durationMs: 209032 isPreviewOnly: false plays: 18406 likes: 371 reposts: 16 comments: 7 downloads: 0 createdAt: '2025-04-01T18:51:35Z' releaseDate: '2025-04-04T00:00:00Z' displayDate: '2025-04-04T00:00:00Z' lastModified: '2025-04-03T15:29:07Z' isDownloadable: false isCommentable: true isStreamable: true isPublic: true license: all-rights-reserved labelName: Foreign Family Collective purchase: title: null url: https://odesza.lnk.to/severance-rmxSo policy: ALLOW monetizationModel: NOT_APPLICABLE embeddableBy: all publisher: artist: ODESZA and Theodore Shapiro albumTitle: 'Music To Refine To: A Remix Companion to Severance' releaseTitle: Mammalians Nurturable (ODESZA Severance Remix) isrc: GBCFB2500164 upc: '5054429203936' isExplicit: false pLine: >- ℗ 2025 FIFTH SEASON LLC and Apple Video Programming LLC, under license to Foreign Family Collective. All Rights Reserved. cLine: >- © 2025 FIFTH SEASON LLC and Apple Video Programming LLC, under license to Foreign Family Collective. All Rights Reserved. containsMusic: true transcodings: - url: >- https://api-v2.soundcloud.com/media/soundcloud:tracks:2068581252/4dc158ae-ca2a-464f-abfa-ae6a6929305b/stream/cbc-encrypted-hls preset: aac_160k protocol: cbc-encrypted-hls mimeType: audio/mp4; codecs="mp4a.40.2" quality: sq isSnippet: false durationMs: 209046 isLegacy: false - url: >- https://api-v2.soundcloud.com/media/soundcloud:tracks:2068581252/4dc158ae-ca2a-464f-abfa-ae6a6929305b/stream/ctr-encrypted-hls preset: aac_160k protocol: ctr-encrypted-hls mimeType: audio/mp4; codecs="mp4a.40.2" quality: sq isSnippet: false durationMs: 209046 isLegacy: false - url: >- https://api-v2.soundcloud.com/media/soundcloud:tracks:2068581252/ca3b567f-4de2-4fe9-9608-62756767ce8f/stream/cbc-encrypted-hls preset: aac_96k protocol: cbc-encrypted-hls mimeType: audio/mp4; codecs="mp4a.40.2" quality: lq isSnippet: false durationMs: 209046 isLegacy: false artist: id: '18604897' handle: odesza url: https://soundcloud.com/odesza name: ODESZA avatarUrl: >- https://i1.sndcdn.com/avatars-9N0KOFupZRs2l2QQ-seYNnA-large.jpg isVerified: true followers: 783898 - id: '2068581236' urn: soundcloud:tracks:2068581236 title: Music of Wellness (ODESZA Severance Remix) url: https://soundcloud.com/odesza/music-of-wellness-odesza description: >- 'Music To Refine To: A Remix Companion to Severance', out now on Foreign Family Collective: https://odesza.lnk.to/severance-rmxSo Follow ODESZA - Spotify: https://found.ee/odesza-sp Apple Music: https://found.ee/odesza-am Amazon Music: https://found.ee/odesza-aa YouTube: https://found.ee/odesza-yt Bandcamp: https://found.ee/odesza-bc Soundcloud: https://found.ee/odesza-sc Instagram: https://found.ee/odesza-ig Discord: https://found.ee/odesza-dc TikTok: https://found.ee/odesza-tt Facebook: https://found.ee/odesza-fb X (Twitter): https://found.ee/odesza-tw #ODESZA #ForeignFamilyCollective genre: Electronic tags: [] artworkUrl: https://i1.sndcdn.com/artworks-IsDx9qev2kON-0-large.png waveformUrl: https://wave.sndcdn.com/FeKeUiHKOzK5_m.json durationMs: 172042 isPreviewOnly: false plays: 34179 likes: 1069 reposts: 29 comments: 13 downloads: 0 createdAt: '2025-04-01T18:51:35Z' releaseDate: '2025-04-04T00:00:00Z' displayDate: '2025-04-04T00:00:00Z' lastModified: '2025-04-03T15:28:55Z' isDownloadable: false isCommentable: true isStreamable: true isPublic: true license: all-rights-reserved labelName: Foreign Family Collective purchase: title: null url: https://odesza.lnk.to/severance-rmxSo policy: ALLOW monetizationModel: NOT_APPLICABLE embeddableBy: all publisher: artist: ODESZA and Theodore Shapiro albumTitle: 'Music To Refine To: A Remix Companion to Severance' releaseTitle: Music of Wellness (ODESZA Severance Remix) isrc: GBCFB2500165 upc: '5054429203936' isExplicit: false pLine: >- ℗ 2025 FIFTH SEASON LLC and Apple Video Programming LLC, under license to Foreign Family Collective. All Rights Reserved. cLine: >- © 2025 FIFTH SEASON LLC and Apple Video Programming LLC, under license to Foreign Family Collective. All Rights Reserved. containsMusic: true transcodings: - url: >- https://api-v2.soundcloud.com/media/soundcloud:tracks:2068581236/2f2b9001-03ae-4605-b141-d962fe55d2e8/stream/cbc-encrypted-hls preset: aac_160k protocol: cbc-encrypted-hls mimeType: audio/mp4; codecs="mp4a.40.2" quality: sq isSnippet: false durationMs: 172046 isLegacy: false - url: >- https://api-v2.soundcloud.com/media/soundcloud:tracks:2068581236/2f2b9001-03ae-4605-b141-d962fe55d2e8/stream/ctr-encrypted-hls preset: aac_160k protocol: ctr-encrypted-hls mimeType: audio/mp4; codecs="mp4a.40.2" quality: sq isSnippet: false durationMs: 172046 isLegacy: false - url: >- https://api-v2.soundcloud.com/media/soundcloud:tracks:2068581236/11d9390e-10c1-4b7c-8dbb-94dbe214a1d2/stream/cbc-encrypted-hls preset: aac_96k protocol: cbc-encrypted-hls mimeType: audio/mp4; codecs="mp4a.40.2" quality: lq isSnippet: false durationMs: 172046 isLegacy: false artist: id: '18604897' handle: odesza url: https://soundcloud.com/odesza name: ODESZA avatarUrl: >- https://i1.sndcdn.com/avatars-9N0KOFupZRs2l2QQ-seYNnA-large.jpg isVerified: true followers: 783898 count: 20 cursor: eyJoIjoib2Rlc3phIiwicCI6Mn0 hasMore: true fetchedAt: '2026-11-11T09:06:12.909Z' meta: requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f creditsCharged: 1 creditsRemaining: 4999 cached: false '400': description: Invalid or expired cursor (or one for another artist). content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: BAD_REQUEST message: The request was invalid. requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f '401': description: Missing, invalid, or revoked API key. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: UNAUTHORIZED message: API key required — pass it in the `x-api-key` header. requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f '402': description: Not enough credits for this request. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: INSUFFICIENT_CREDITS message: >- This request costs 1 credit, but your balance is 0. Top up to continue. requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f '404': description: No SoundCloud account with that handle. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: NOT_FOUND message: >- The requested content was not found (it may not exist, be deleted, or be private). requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f '422': description: Invalid query parameters (`handle` or `url` is required). content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: VALIDATION_ERROR message: Request validation failed requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f details: - path: url message: url is required '429': description: Over the per-minute rate limit — honour `Retry-After`. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: RATE_LIMITED message: >- Rate limit exceeded — max 100 requests per 60s. Retry in ~30s. requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f '503': description: >- Temporarily unavailable — retry after `Retry-After`. `error.code` tells you why: `UPSTREAM_BLOCKED` (the source blocked this request), `EXTRACTION_FAILED` (the source returned unexpected data), `PLATFORM_UNAVAILABLE` (the source is down), or `SERVICE_UNAVAILABLE` (we are at capacity). content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: UPSTREAM_BLOCKED message: >- The source is temporarily unavailable. Please try again shortly. requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f components: schemas: Error: type: object properties: error: type: object properties: code: type: string example: NOT_FOUND message: type: string example: The requested content was not found. requestId: type: string example: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f details: type: array items: type: object description: Present on validation errors. required: - code - message - requestId required: - error securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- Your API key. Send it in the `x-api-key` header (or `Authorization: Bearer `). Create and manage keys from your dashboard. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.