# SoundCloud Scraper (`crawlerbros/soundcloud-scraper`) Actor Scrape SoundCloud with search tracks and artists, browse top/trending charts, fetch all tracks from an artist, or fetch any track/playlist/user URL. Extracts plays, likes, reposts, waveforms, artwork, genre, tags, and stream URLs. No API key required. - **URL**: https://apify.com/crawlerbros/soundcloud-scraper.md - **Developed by:** [Crawler Bros](https://apify.com/crawlerbros) (community) - **Categories:** Social media, Developer tools, Other - **Stats:** 1 total users, 0 monthly users, 100.0% runs succeeded, 4 bookmarks - **User rating**: 5.00 out of 5 stars ## Pricing from $3.00 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## SoundCloud Scraper Extract tracks, playlists, and artist profiles from [SoundCloud](https://soundcloud.com) — including play counts, likes, reposts, genre, tags, waveforms, artwork, and stream URLs. No API key or account required. ### What This Actor Does - **Charts** — browse top or trending tracks by genre (all music, hip-hop, electronic, pop, and 25+ more genres) - **Search** — search for tracks, users/artists, playlists, or albums by keyword - **Artist Tracks** — fetch all tracks from a specific artist profile - **By URL** — resolve any SoundCloud track, playlist, or user URL to structured data --- ### Output Fields Each record contains the following fields (omit-empty — fields absent when not available): | Field | Type | Description | |---|---|---| | `title` | string | Track, playlist, or artist name | | `url` | string | Direct SoundCloud URL | | `trackId` | string | SoundCloud internal ID | | `artist` | string | Artist/uploader username | | `artistUrl` | string | URL to the artist's SoundCloud profile | | `duration` | string | Duration in MM:SS or HH:MM:SS format | | `playCount` | integer | Total play count | | `likeCount` | integer | Number of likes/favorites | | `repostCount` | integer | Number of reposts | | `commentCount` | integer | Number of comments | | `genre` | string | Genre label | | `tags` | array | List of tags attached to the track | | `uploadDate` | string | ISO-8601 upload date | | `streamUrl` | string | Direct stream/transcoding URL | | `artworkUrl` | string | High-resolution artwork image URL (500×500) | | `waveformUrl` | string | Waveform image URL | | `description` | string | Track or artist description | | `recordType` | string | Record type: `track`, `user`, or `playlist` | | `scrapedAt` | string | ISO-8601 scrape timestamp | #### Example Output ```json { "title": "Chill Lofi Beat", "url": "https://soundcloud.com/artist/chill-lofi-beat", "trackId": "12345678", "artist": "lofi_producer", "artistUrl": "https://soundcloud.com/lofi_producer", "duration": "3:45", "playCount": 125000, "likeCount": 4200, "repostCount": 890, "commentCount": 145, "genre": "Hip-hop & Rap", "tags": ["lofi", "chill", "beats", "study"], "uploadDate": "2023-08-15T14:32:00+00:00", "streamUrl": "https://api-v2.soundcloud.com/media/...", "artworkUrl": "https://i1.sndcdn.com/artworks-...-t500x500.jpg", "waveformUrl": "https://wave.sndcdn.com/..._m.png", "description": "Chill lofi hip-hop beats for studying and relaxing.", "recordType": "track", "scrapedAt": "2024-12-15T10:30:00+00:00" } ```` *** ### Input Configuration #### Mode | Value | Description | |---|---| | `charts` | Top/trending tracks by genre (default) | | `search` | Search tracks, users, playlists, or albums | | `artistTracks` | All tracks from a specific artist profile | | `byUrl` | Fetch a specific track/playlist/user URL | #### Input Fields | Field | Type | Default | Description | |---|---|---|---| | `mode` | select | `charts` | Scraping mode | | `chartKind` | select | `top` | `top` (most-played) or `trending` | | `genre` | select | `all-music` | Genre filter for charts and search | | `searchQuery` | string | `chill lofi` | Search keyword (mode=search) | | `searchKind` | select | `tracks` | What to search: tracks, users, playlists, albums | | `artistUrl` | string | — | Artist profile URL (mode=artistTracks) | | `startUrls` | array | `[]` | URLs to scrape (mode=byUrl) | | `maxItems` | integer | 20 | Maximum records to return (1–500) | #### Available Genres All Music, Alternative Rock, Ambient, Classical, Country, Dance & EDM, Dancehall, Deep House, Disco, Drum & Bass, Dubstep, Electronic, Folk & Singer-Songwriter, Hip-hop & Rap, House, Indie, Jazz & Blues, Latin, Metal, Piano, Pop, R\&B & Soul, Reggae, Reggaeton, Rock, Soundtrack, Techno, Trance, Trap, Trip Hop, World *** ### Use Cases - **Music discovery** — find trending tracks by genre without a SoundCloud account - **Artist research** — extract a complete discography from any public SoundCloud profile - **Playlist curation** — gather track metadata for playlist building tools - **Music analytics** — monitor play counts, likes, and reposts over time - **Content monitoring** — track new uploads from specific artists - **Podcast discovery** — SoundCloud hosts many podcasts; use search to find episodes *** ### FAQ **Does this require a SoundCloud account?**\ No. All data is extracted from public SoundCloud pages and the public API. No login or API key is required. **How does the actor get the SoundCloud client\_id?**\ SoundCloud embeds a rotating `client_id` in their public JavaScript bundles. The actor automatically extracts this from the homepage before making API calls. **Can I download the audio files?**\ The `streamUrl` field provides the SoundCloud stream URL. Whether you can download from it depends on the track's streaming permissions set by the artist. **What's the difference between `top` and `trending` charts?**\ `top` returns the most-played tracks of all time in a genre. `trending` returns what's gaining traction right now. **Why might `playCount` be missing on some tracks?**\ SoundCloud only returns play counts for tracks with a sufficient play history. New or private tracks may not have this data. **How many tracks can I fetch per run?**\ Up to 500 records per run using the `maxItems` parameter. For larger datasets, run multiple times with different genres or search queries. **Can I scrape private tracks?**\ No. The actor only accesses public tracks available without authentication. # Actor input Schema ## `mode` (type: `string`): What to scrape. ## `chartKind` (type: `string`): Which chart to fetch (mode=charts). ## `genre` (type: `string`): Genre for charts or search filtering. ## `searchQuery` (type: `string`): Search term for tracks, users, or playlists (mode=search). ## `searchKind` (type: `string`): Type of results to search for (mode=search). ## `artistUrl` (type: `string`): SoundCloud artist profile URL (mode=artistTracks). Example: https://soundcloud.com/artist-name ## `startUrls` (type: `array`): SoundCloud track, playlist, or user URLs to scrape (mode=byUrl). ## `maxItems` (type: `integer`): Maximum number of records to emit. ## Actor input object example ```json { "mode": "charts", "chartKind": "top", "genre": "soundcloud:genres:all-music", "searchQuery": "chill lofi", "searchKind": "tracks", "startUrls": [], "maxItems": 20 } ``` # Actor output Schema ## `tracks` (type: `string`): Dataset containing all scraped SoundCloud tracks, playlists, and user profiles. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "mode": "charts", "chartKind": "top", "genre": "soundcloud:genres:all-music", "searchQuery": "chill lofi", "searchKind": "tracks", "startUrls": [], "maxItems": 20 }; // Run the Actor and wait for it to finish const run = await client.actor("crawlerbros/soundcloud-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "mode": "charts", "chartKind": "top", "genre": "soundcloud:genres:all-music", "searchQuery": "chill lofi", "searchKind": "tracks", "startUrls": [], "maxItems": 20, } # Run the Actor and wait for it to finish run = client.actor("crawlerbros/soundcloud-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "mode": "charts", "chartKind": "top", "genre": "soundcloud:genres:all-music", "searchQuery": "chill lofi", "searchKind": "tracks", "startUrls": [], "maxItems": 20 }' | apify call crawlerbros/soundcloud-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=crawlerbros/soundcloud-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "SoundCloud Scraper", "description": "Scrape SoundCloud with search tracks and artists, browse top/trending charts, fetch all tracks from an artist, or fetch any track/playlist/user URL. Extracts plays, likes, reposts, waveforms, artwork, genre, tags, and stream URLs. No API key required.", "version": "1.0", "x-build-id": "gL2lo9rLLHwPacJD7" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~soundcloud-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-soundcloud-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/crawlerbros~soundcloud-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-soundcloud-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/crawlerbros~soundcloud-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-soundcloud-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "charts", "search", "artistTracks", "byUrl" ], "type": "string", "description": "What to scrape.", "default": "charts" }, "chartKind": { "title": "Chart kind", "enum": [ "top", "trending" ], "type": "string", "description": "Which chart to fetch (mode=charts).", "default": "top" }, "genre": { "title": "Genre", "enum": [ "soundcloud:genres:all-music", "soundcloud:genres:alternativerock", "soundcloud:genres:ambient", "soundcloud:genres:classical", "soundcloud:genres:country", "soundcloud:genres:danceedm", "soundcloud:genres:dancehall", "soundcloud:genres:deephouse", "soundcloud:genres:disco", "soundcloud:genres:drumbass", "soundcloud:genres:dubstep", "soundcloud:genres:electronic", "soundcloud:genres:folksingersongwriter", "soundcloud:genres:hiphoprap", "soundcloud:genres:house", "soundcloud:genres:indie", "soundcloud:genres:jazzblues", "soundcloud:genres:latin", "soundcloud:genres:metal", "soundcloud:genres:piano", "soundcloud:genres:pop", "soundcloud:genres:rbsoul", "soundcloud:genres:reggae", "soundcloud:genres:reggaeton", "soundcloud:genres:rock", "soundcloud:genres:soundtrack", "soundcloud:genres:techno", "soundcloud:genres:trance", "soundcloud:genres:trap", "soundcloud:genres:triphop", "soundcloud:genres:world" ], "type": "string", "description": "Genre for charts or search filtering.", "default": "soundcloud:genres:all-music" }, "searchQuery": { "title": "Search query", "type": "string", "description": "Search term for tracks, users, or playlists (mode=search).", "default": "chill lofi" }, "searchKind": { "title": "Search kind", "enum": [ "tracks", "users", "playlists", "albums" ], "type": "string", "description": "Type of results to search for (mode=search).", "default": "tracks" }, "artistUrl": { "title": "Artist URL", "type": "string", "description": "SoundCloud artist profile URL (mode=artistTracks). Example: https://soundcloud.com/artist-name" }, "startUrls": { "title": "Start URLs (mode=byUrl)", "type": "array", "description": "SoundCloud track, playlist, or user URLs to scrape (mode=byUrl).", "default": [], "items": { "type": "string" } }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum number of records to emit.", "default": 20 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```