# Soundcloud Mp3 Downloader (`solid-scraper/soundcloud-mp3-downloader`) Actor 🎵 Soundcloud MP3 Downloader—convert your favorite tracks to MP3 in seconds! 🚀 Fast, easy, and high-quality downloads for offline listening. 📥 Grab tracks from SoundCloud anytime, anywhere. Perfect for music fans. 🎧 - **URL**: https://apify.com/solid-scraper/soundcloud-mp3-downloader.md - **Developed by:** [SolidScraper](https://apify.com/solid-scraper) (community) - **Categories:** Automation, Other - **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $2.99 / 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. 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 MP3 Downloader 🎧 **SoundCloud MP3 Downloader** is an Apify actor that helps you turn **SoundCloud track links** into **direct audio URLs** for download-ready audio files. If you’re looking for a **SoundCloud to MP3 downloader**, an **online SoundCloud MP3 download**, or a **SoundCloud mp3 converter** workflow without doing it manually track by track, this actor is built for you. Whether you’re a marketer, data analyst, researcher, or music enthusiast, you can batch process public SoundCloud track pages and save time—especially when you need results at scale instead of clicking through one URL at a time. --- ### Why choose SoundCloud MP3 Downloader? | Feature | Benefit | | --- | --- | | ✅ **Track URL to direct audio URL extraction** | Convert SoundCloud track links into download-ready media links in one run | | ✅ **Reliability with built-in fallbacks** | Includes resilience when required page data isn’t immediately available | | ✅ **Structured output for every input link** | Each item is returned with consistent fields for easy analysis and import | | ✅ **Scales for batches** | Process multiple SoundCloud track pages by providing a list of URLs | | ✅ **Built-in proxy support for reliable scraping** | Improves stability for higher-volume runs using your chosen proxy setting | | ✅ **Clear success vs error results** | You get an `error` state and `message` when a track fails to process | --- ### Key features - 🎵 **SoundCloud track to MP3 conversion flow**: Takes SoundCloud URLs and returns direct audio media links (as extracted “medias”) - 🔗 **URL input support for track pages**: Works from an array of SoundCloud links you provide in the actor input - 🛡️ **Resilient fetching and fallbacks**: Uses fallback logic when required runtime identifiers can’t be found immediately - 🔄 **Stable, consistent per-link results**: Pushes one result object per input URL, including timing in `time_end` - 💾 **Structured JSON output for downstream use**: Produces a clear `result` object with metadata like `author`, `title`, `duration`, and `thumbnail` - 🌐 **Audio media details included**: Returns `url`, `quality`, `extension`, and `type` for each extracted media item - ⚙️ **Proxy configuration support**: Lets you enable proxy usage via the provided input setting for more dependable runs --- ### Input Provide input via an `input.json` file. Example structure: ```json { "links": [ "https://soundcloud.com/cloudstechno/ocean-drive" ] } ```` #### Input Fields | Field | Required | Description | | --- | --- | --- | | `links` | ✅ | List of SoundCloud URLs to scrape. Provide one or more SoundCloud track page links you want to convert into direct audio URLs. | > Note: The actor code also reads `proxyConfiguration` from input (`actor_input.get("proxyConfiguration", {})`). In the provided repo input schema, only `links` is formally defined as required. *** ### Output The actor pushes each processed link’s data into a JSON result object (one per input URL). Example output for a single track (success): ```json { "url": "https://soundcloud.com/cloudstechno/ocean-drive", "result": { "url": "https://soundcloud.com/cloudstechno/ocean-drive", "source": "soundcloud", "author": "Cloudstechno", "title": "Ocean Drive", "thumbnail": "https://example.com/thumb.jpg", "duration": "3:42", "medias": [ { "url": "https://example.com/direct-audio-stream", "quality": "audio", "extension": "mp3", "type": "audio" } ], "type": "single", "error": false, "time_end": 1250 } } ``` Example output for a single track (error): ```json { "url": "https://soundcloud.com/cloudstechno/ocean-drive", "result": { "url": "https://soundcloud.com/cloudstechno/ocean-drive", "error": true, "message": "Could not find window.__sc_hydration in page content." } } ``` #### Output Fields | Field | Type | Description | | --- | --- | --- | | `url` | string | The input URL that was processed | | `result` | object | Result wrapper for the processing outcome | | `result.url` | string | The track URL associated with this result | | `result.source` | string | Data source label (e.g. `soundcloud`) | | `result.author` | string | Track author name (if available) | | `result.title` | string | Track title (if available) | | `result.thumbnail` | string | Thumbnail URL (taken from track artwork or author avatar) | | `result.duration` | string | Track duration formatted as `m:ss` or `h:mm:ss` | | `result.medias` | array | Extracted media entries (each includes direct audio URL and format details) | | `result.type` | string | Set to `single` | | `result.error` | boolean | `false` for success, `true` for failure | | `result.time_end` | number | Processing time in milliseconds for that URL (`int((time.time() - start_time) * 1000)`) | | `result.message` | string | Error details when `error` is `true` | For `result.medias`, each media item contains: - `url` (direct media URL) - `quality` (set to `"audio"`) - `extension` (e.g. `"mp3"`, `"ogg"`, or `"mp4"` depending on detected preset/mime type) - `type` (set to `"audio"`) *** ### How to use SoundCloud MP3 Downloader (via Apify Console) 1. **Open Apify Console**\ Log in at [console.apify.com](https://console.apify.com) and go to the **Actors** tab. 2. **Find the actor**\ Search for **SoundCloud MP3 Downloader** and open the actor page. 3. **Add your input**\ In the **INPUT** section, paste JSON with your SoundCloud track links, for example: ```json { "links": ["https://soundcloud.com/cloudstechno/ocean-drive"] } ``` 4. **(Optional) Configure proxy settings**\ If you want proxy usage for more reliable scraping during larger batches, adjust the **proxy configuration** in the input UI (the actor checks for `proxyConfiguration.proxy support`). 5. **Run the actor**\ Click **Run** to start converting your **SoundCloud MP3 download** requests into extracted direct audio URLs. 6. **Monitor logs**\ Watch the logs for messages like `Scraping: ` and any errors returned per link (including failure `message`). 7. **Open results**\ After completion, go to the **OUTPUT** tab to view the JSON results for each provided SoundCloud URL. 8. **Export and use the data**\ Export the dataset to your preferred format (commonly JSON/CSV via Apify’s export tools) and plug it into your workflow for `SoundCloud MP3 download` automation. No coding required—get SoundCloud to MP3 results in minutes. 🚀 *** ### Advanced features & SEO optimization - 🎯 **Engineered for “SoundCloud MP3 download” workflows**: Designed to extract direct audio links from public SoundCloud track URLs, supporting “SoundCloud mp3 converter” use cases. - 🔄 **Fallback-based resilience**: If certain required data is missing from the page response, the actor applies fallback logic so batch runs fail less often. - 📊 **Rich metadata alongside media links**: You get `author`, `title`, `duration`, `thumbnail`, plus the extracted `medias` list—useful for cataloging and QA. - 🧰 **Batch processing for “download SoundCloud mp3” at scale**: Provide multiple URLs in `links` and process them in a single execution. - 🕒 **Per-link timing in output**: Each successful result includes `time_end` so you can spot slow requests during large jobs. *** ### Best use cases - 📈 **Marketing teams scaling content sourcing**: Rapidly compile direct audio URLs for SoundCloud audio assets without manually checking each track. - 🔍 **Music researchers and analysts**: Collect structured track metadata (title, author, duration, thumbnail) plus media links for analysis pipelines. - 🧾 **Catalog managers and curators**: Build consistent datasets that include “SoundCloud audio downloader” outputs for internal libraries. - 🛠️ **Automation engineers**: Feed extracted `medias.url` links into downstream automation for archiving, validation, or ingestion. - 💻 **Data pipelines for “SoundCloud MP3 download for free” style experiments**: Use the actor to prototype workflows for “download without app” approaches (from publicly available sources). - 🎧 **Community curators and creators**: Convert lists of SoundCloud tracks into organized audio-link datasets for easier sharing workflows. *** ### Technical specifications - **Supported Input Formats** - ✅ `links` as an array of SoundCloud URLs (`string` items) - **Proxy Support** - ✅ Proxy configuration is read from input via `proxyConfiguration` - ✅ The actor checks `proxyConfiguration.proxy support` to decide whether to use Apify proxy support - **Retry Mechanism** - ✅ Includes resilience through fallback logic for required runtime identifiers and extraction blocks (details are handled internally) - **Dataset Structure** - ✅ JSON objects pushed per input link under a `result` wrapper - ✅ Success results contain `result.medias` (array of audio media entries) - ✅ Failure results contain `result.error: true` and `result.message` - **Rate Limits & Performance** - ⚠️ Performance depends on page accessibility and response times; each item also reports `time_end` in milliseconds - **Limitations** - ❌ If the actor cannot extract required page content (or track media details), the result will be returned with `error: true` and a `message` *** ### FAQ #### Does SoundCloud MP3 Downloader work with multiple SoundCloud links at once? ✅ Yes. You can pass an array in the `links` field, and the actor will process each SoundCloud URL and push a result object per link. #### What does the actor actually return for a successful track? ✅ It returns track metadata (like `author`, `title`, `thumbnail`, and `duration`) and a `medias` array that includes direct audio URLs (`medias.url`), along with `quality`, `extension`, and `type`. #### Is the output always an MP3 file? ✅ Not necessarily. The actor extracts direct audio media and sets `medias.extension` based on detected preset/mime-type logic. Common outcomes include `mp3`, but the output may also show other audio extensions such as `ogg` or `mp4`. #### What happens if a track page can’t be processed? ❌ The actor pushes a result with `result.error: true` and includes `result.message` describing the failure. #### Do I need an API key or coding to use this? ✅ No coding required to run it in Apify Console. If you want to integrate programmatically, you can run the actor and consume its dataset output through your existing automation setup, but the actor itself is usable directly from the Apify UI. #### Is there a dataset export option for results? ✅ Yes. After the run completes, you can open the OUTPUT tab to view results and export the dataset (typically to JSON/CSV via Apify’s export tools). #### Can I use proxies for better stability? ✅ The actor supports proxy usage through the `proxyConfiguration` input (including checking `proxyConfiguration.proxy support`). This can help with reliability during larger batches. #### Is it legal to use SoundCloud MP3 Downloader for downloads? ✅ The tool works with publicly available sources, but legal compliance (including GDPR/CCPA where applicable) and adherence to platform rules is your responsibility. *** ### Support & feature requests Want to improve your **SoundCloud MP3 Downloader** workflow? Share your feedback—your ideas help shape the roadmap. 🎧 - 💡 **Feature Requests**: Examples include adding CSV-friendly output fields, supporting additional transformations, or improving how `medias` quality/format info is represented for “SoundCloud MP3 download” automation. - 📧 **Contact**: For questions or requests, email . Thanks for helping make this SoundCloud audio extraction actor even better—your feedback drives real improvements. ✅ *** *If you need a dependable SoundCloud to MP3 downloader for batch workflows, this **SoundCloud MP3 Downloader** is built to help you get structured, export-ready results fast.* # Actor input Schema ## `links` (type: `array`): List of SoundCloud URLs to scrape ## Actor input object example ```json { "links": [ "https://soundcloud.com/cloudstechno/ocean-drive" ] } ``` # 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 = { "links": [ "https://soundcloud.com/cloudstechno/ocean-drive" ] }; // Run the Actor and wait for it to finish const run = await client.actor("solid-scraper/soundcloud-mp3-downloader").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 = { "links": ["https://soundcloud.com/cloudstechno/ocean-drive"] } # Run the Actor and wait for it to finish run = client.actor("solid-scraper/soundcloud-mp3-downloader").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 '{ "links": [ "https://soundcloud.com/cloudstechno/ocean-drive" ] }' | apify call solid-scraper/soundcloud-mp3-downloader --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=solid-scraper/soundcloud-mp3-downloader", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Soundcloud Mp3 Downloader", "description": "🎵 Soundcloud MP3 Downloader—convert your favorite tracks to MP3 in seconds! 🚀 Fast, easy, and high-quality downloads for offline listening. 📥 Grab tracks from SoundCloud anytime, anywhere. Perfect for music fans. 🎧", "version": "0.1", "x-build-id": "fQMkVxHvBsqOSfjkm" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solid-scraper~soundcloud-mp3-downloader/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solid-scraper-soundcloud-mp3-downloader", "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/solid-scraper~soundcloud-mp3-downloader/runs": { "post": { "operationId": "runs-sync-solid-scraper-soundcloud-mp3-downloader", "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/solid-scraper~soundcloud-mp3-downloader/run-sync": { "post": { "operationId": "run-sync-solid-scraper-soundcloud-mp3-downloader", "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": [ "links" ], "properties": { "links": { "title": "SoundCloud Links", "type": "array", "description": "List of SoundCloud URLs to scrape", "items": { "type": "string" }, "default": [ "https://soundcloud.com/cloudstechno/ocean-drive" ] } } }, "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 } } } } } } } } } } ```