# SoundCloud Scraper - Artists, Tracks & Creator Leads (`scrapesage/soundcloud-scraper`) Actor Scrape SoundCloud: search artists & tracks, full creator profiles, tracks, albums & playlists, plus creator-contact leads (booking/management emails, socials, website). Followers, plays, genres, monitoring. No login, no API key, no browser. - **URL**: https://apify.com/scrapesage/soundcloud-scraper.md - **Developed by:** [Scrape Sage](https://apify.com/scrapesage) (community) - **Categories:** Social media, Lead generation, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $6.00 / 1,000 artist scrapeds This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. 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 — Artists, Tracks & Creator Leads (Emails, Socials & Plays) Extract **complete SoundCloud data** — full artist profiles (followers, track counts, play counts, city, country, Pro status), tracks and playlists with genres and play stats, **and** turn every artist into a **ready-to-contact creator lead**: the **booking/management email** from their bio, every linked social (Instagram, YouTube, Spotify, Twitter/X, TikTok, Facebook), and — optionally — emails & phone numbers crawled from their own website. No login, no OAuth, no API key, no browser — fast JSON extraction from SoundCloud's own public API with 99%+ reliability. ### Why this SoundCloud scraper? Most SoundCloud scrapers return a track list and stop. This actor pulls from SoundCloud's internal `api-v2` and ships the **richest dataset in the category**, built for **A&R, sync licensing, distribution, PR, and artist outreach**: | Data | Typical scrapers | This actor | |---|---|---| | Artist followers, track count, play/like counts | partial | ✅ | | City, country, Pro/Next subscription, verified | ❌ | ✅ | | **Booking / management email** (from the bio) | ❌ | ✅ | | Linked socials — Instagram, YouTube, Spotify, TikTok, X | ❌ | ✅ | | Artist's own **website** + crawled contact emails/phones | ❌ | ✅ opt-in | | Lead score (0–100) per artist | ❌ | ✅ | | Tracks: genre, plays, likes, reposts, ISRC, license, label | partial | ✅ | | Playlists & albums (track count, genre, release date) | ❌ | ✅ opt-in | | Monitoring — only new artists / tracks since last run | ❌ | ✅ | ### Use cases - **Music-industry lead generation** — find independent artists, producers and beatmakers by genre or keyword and reach them directly via their **booking/management email** and socials. Score them by reach (`followerCount`, `playbackCount`). - **A&R & talent scouting** — discover rising artists in a genre, filter by followers/plays, and monitor for **new uploads** with Schedules. - **Sync, distribution & label outreach** — build target lists of unsigned artists with contact data, label names and ISRCs. - **Playlist & catalog research** — pull tracks and playlists with genres, play counts and release dates for trend and market analysis. - **PR & influencer marketing** — find creators by audience size and topic, then contact them with verified emails and social handles. ### How to use 1. [Sign up for Apify](https://console.apify.com/sign-up) — the free plan is enough to try this actor. 2. Open the **SoundCloud Scraper**, choose a mode, enter search terms (or paste artist URLs), and click **Start**. 3. Watch results stream into the dataset table. 4. **Export** as JSON, CSV, Excel, XML, or RSS — or pull results programmatically via the [Apify API](https://docs.apify.com/api/v2). ### Input ```json { "mode": "searchArtists", "searchTerms": ["lofi", "techno producer"], "maxResultsPerQuery": 50, "includeWebProfiles": true, "includeTracks": true, "maxTracksPerArtist": 10, "enrichCreatorContacts": true, "withEmailOnly": false } ```` - **mode** — `searchArtists` (creators by keyword + leads), `artistDetails` (full profiles for specific artists, plus tracks/playlists), or `searchTracks` (tracks by keyword). - **searchTerms** — keywords, genres or artist names. One row per term. Used by the search modes. - **artistUrls** — profile URLs (`https://soundcloud.com/flume`), bare permalinks (`flume`) or numeric user ids. Used by `artistDetails`. - **maxResultsPerQuery** — cap per search term (auto-paginated). - **includeWebProfiles** *(default true)* — fetch each artist's linked socials + website (the lead wedge). - **includeTracks / maxTracksPerArtist** — also output recent tracks per artist (type `track`). - **includePlaylists / maxPlaylistsPerArtist** — also output playlists & albums per artist (type `playlist`). - **enrichCreatorContacts** *(default false)* — crawl the artist's own website (home + contact/about, max 3 pages) for emails, phone and extra socials. - **minFollowers / withEmailOnly** — output filters to tighten the result set to qualified leads. - **monitorMode** *(default false)* — emit only records not seen in previous runs (see below). ### Output One record per artist (`type: "artist"`), plus optional `track` and `playlist` records: ```json { "type": "artist", "userId": 2976616, "urn": "soundcloud:users:2976616", "username": "flume", "displayName": "Flume", "profileUrl": "https://soundcloud.com/flume", "description": "Management: management@example.com", "city": "Sydney", "countryCode": "AU", "followerCount": 2227189, "trackCount": 231, "playlistCount": 46, "likesCount": 149, "isVerified": true, "isPro": true, "subscriptionTier": "creator-pro-unlimited", "avatarUrl": "https://i1.sndcdn.com/avatars-...-large.jpg", "website": "https://example.store", "socialLinks": { "facebook": "http://www.facebook.com/flumemusic", "twitter": "http://twitter.com/flumemusic", "youtube": "https://www.youtube.com/user/flumeaus", "instagram": "http://instagram.com/flume", "spotify": "https://open.spotify.com/artist/..." }, "webProfiles": [ { "network": "instagram", "title": "Instagram", "url": "http://instagram.com/flume", "username": "flume" } ], "descriptionEmails": ["management@example.com"], "contactEmails": [], "contactPhones": [], "leadScore": 92, "searchQuery": "electronic", "scrapedAt": "2026-06-16T00:00:00.000Z" } ``` A `track` record carries `trackId`, `title`, `permalinkUrl`, `genre`, `playbackCount`, `likesCount`, `repostsCount`, `commentCount`, `durationMs`/`durationFormatted`, `license`, `labelName`, `isrc`, `releaseDate`, plus the artist summary (`artistId`, `artistName`, `artistUrl`). ### Automate & schedule Run this actor on autopilot and pull results into your own stack: - **[Apify API](https://docs.apify.com/api/v2)** — start runs, fetch datasets, and manage schedules over REST. - **[apify-client for JavaScript](https://docs.apify.com/api/client/js/)** and **[apify-client for Python](https://docs.apify.com/api/client/python/)** — official SDKs. - **[Schedules](https://docs.apify.com/platform/schedules)** — run it hourly/daily/weekly with **monitorMode** on to capture only new artists or new uploads in a genre; perfect for A\&R pipelines and newsletters. - **[Webhooks](https://docs.apify.com/platform/integrations/webhooks)** — trigger downstream actions (CRM import, Slack alert, email sequence) the moment a run finishes. ```js import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: 'MY_APIFY_TOKEN' }); const run = await client.actor('scrapesage/soundcloud-scraper').call({ mode: 'searchArtists', searchTerms: ['hip hop beats'], maxResultsPerQuery: 50, enrichCreatorContacts: true, withEmailOnly: true, }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(`Got ${items.length} artist leads`); ``` ### Integrate with any app Connect the dataset to 5,000+ apps — no code required: - **[Make](https://docs.apify.com/platform/integrations/make)** — multi-step automation scenarios. - **[Zapier](https://docs.apify.com/platform/integrations/zapier)** — push new creator leads straight into your CRM. - **[Slack](https://docs.apify.com/platform/integrations/slack)** — get notified when a monitored search finds new artists. - **[Google Drive / Sheets](https://docs.apify.com/platform/integrations/drive)** — auto-export every run to a spreadsheet. - **[Airbyte](https://docs.apify.com/platform/integrations/airbyte)** — pipe results into your data warehouse. - **[GitHub](https://docs.apify.com/platform/integrations/github)** — trigger runs from commits or releases. ### Use with AI assistants (MCP) The output is clean, LLM-ready JSON. You can call this actor from Claude, ChatGPT, or any agent framework through the **[Apify MCP server](https://docs.apify.com/platform/integrations/mcp)** — ask your assistant to "find techno producers on SoundCloud with over 10k followers and list their contact emails" and let it run this scraper for you. ### Agent-ready: autonomous payments (x402 & Skyfire) This actor is **agent-ready** — AI agents can discover it, run it, and **pay for it autonomously**, with no Apify account and no human in the loop. It uses [pay-per-event](https://docs.apify.com/platform/actors/publishing/monetize/pay-per-event) pricing and [limited permissions](https://docs.apify.com/platform/actors/development/permissions), so it qualifies for Apify's agentic-payment standards: - **[x402](https://docs.apify.com/platform/integrations/x402)** — an open, HTTP-native payment protocol. Agents pay per run in USDC on the Base network directly through the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp) — no account, no API key. - **[Skyfire](https://docs.apify.com/platform/integrations/skyfire)** — agent-to-service payments for fully autonomous AI-agent workflows. Building an AI agent, MCP tool, or autonomous data pipeline? This scraper is ready to plug in and pay as it goes. ### More scrapers from scrapesage Build a complete **creator / social lead-gen stack**: - **[YouTube Scraper](https://apify.com/scrapesage/youtube-scraper)** — channels, videos and creator-contact leads. - **[Apple Podcasts Scraper](https://apify.com/scrapesage/apple-podcasts-scraper)** — shows, episodes, reviews and host leads. - **[Substack Scraper](https://apify.com/scrapesage/substack-scraper)** — newsletters, posts and creator leads. - **[Telegram Scraper](https://apify.com/scrapesage/telegram-scraper)** — channels, messages, media and search. - **[Product Hunt Scraper](https://apify.com/scrapesage/product-hunt-scraper)** — launches, makers and leads. - **[GitHub Scraper](https://apify.com/scrapesage/github-scraper)** — repos, developers and contact leads. - **[Eventbrite Scraper](https://apify.com/scrapesage/eventbrite-scraper)** — events and organizer leads. - **[Facebook Ad Library Scraper](https://apify.com/scrapesage/facebook-ad-library-scraper)** — competitor ad intelligence. ### Tips - **Genre targeting**: search broad genre terms (`lofi`, `techno`, `drill`, `house`) or niche ones — SoundCloud's search returns artists and tracks ranked by relevance. - **Best leads**: turn on `includeWebProfiles` (default) for socials + website, then `enrichCreatorContacts` to crawl the website, and set `withEmailOnly` to keep only contactable artists. - **Recurring monitoring**: combine [Schedules](https://docs.apify.com/platform/schedules) with `monitorMode` to track only newly listed artists/tracks; it dedupes against earlier runs and never conflicts with the scheduler. - **Cost control**: web-profile fetches and website crawls are per-artist; lower `maxResultsPerQuery` for quick test runs. ### FAQ **Do I need a SoundCloud API key or login?** No. The actor uses SoundCloud's public web API with the same public `client_id` the website uses, discovered automatically at runtime. If SoundCloud rotates that key and results look empty, paste a fresh one into the `clientId` input. **Where do the emails come from?** From the artist's public bio (where many list a "Management" / "Booking" email) and their `webProfiles`. With `enrichCreatorContacts` on, the actor also visits the artist's own public website and extracts publicly listed contact emails — the same thing a human visitor would see. **Can I export to Google Sheets, CSV, or Excel?** Yes — one click in the dataset view, or automatically on every run via the [Google Drive integration](https://docs.apify.com/platform/integrations/drive). **How do I monitor new uploads automatically?** Turn on `monitorMode`, then create a [Schedule](https://docs.apify.com/platform/schedules). Each run emits only artists/tracks not seen before. **A field is null — why?** Some artists genuinely don't publish a city, website or email. Fields are `null` only when the data doesn't exist, not because the scraper skipped them. **Is scraping SoundCloud legal?** This actor collects publicly available data only. You are responsible for using the data in compliance with applicable laws (GDPR/CCPA for personal data) and SoundCloud's terms. ### Need help? Open an issue on the actor's **Issues** tab, or visit the [Apify help center](https://help.apify.com/). Feature requests are welcome — this actor is actively maintained. # Actor input Schema ## `mode` (type: `string`): Pick a job. Search artists finds creators by keyword (full profiles + leads). Artist details pulls full profiles for specific artists (plus their tracks/playlists). Search tracks finds tracks by keyword. ## `searchTerms` (type: `array`): Keywords to search SoundCloud for, e.g. `lofi`, `techno producer`, `hip hop beats`, an artist name, or a genre. One row per term. Used by the Search artists and Search tracks modes. ## `artistUrls` (type: `array`): Artists to pull full details for: profile URLs (`https://soundcloud.com/flume`), bare permalinks (`flume`), or numeric user ids (`2976616`). One per row. (Mode: Artist details.) ## `maxResultsPerQuery` (type: `integer`): Cap the number of artists (or tracks) returned per search term. Results are paginated automatically until this limit or the result set is exhausted. ## `includeWebProfiles` (type: `boolean`): Fetch each artist's linked profiles — Instagram, Twitter/X, Facebook, YouTube, Spotify, their own website and more (one extra request per artist). This is the main lead wedge alongside the booking/management email in the bio. ## `includeTracks` (type: `boolean`): For artist modes, also output recent track records (type `track`) for each artist — title, genre, plays, likes, duration, release date and more. In monitoring mode this returns only NEW tracks since the last run. ## `maxTracksPerArtist` (type: `integer`): How many recent tracks to pull per artist when 'Include artist tracks' is on. ## `includePlaylists` (type: `boolean`): For artist modes, also output playlist/album records (type `playlist`) for each artist — title, track count, genre, release date and more. ## `maxPlaylistsPerArtist` (type: `integer`): How many playlists/albums to pull per artist when 'Include artist playlists & albums' is on. ## `enrichCreatorContacts` (type: `boolean`): Opt-in lead enrichment: visit each artist's own public website (home + a contact/about page) and extract contact emails, phone numbers and social links — for A\&R, sync licensing, distribution, PR and booking outreach. Only runs for artists that list a website. ## `minFollowers` (type: `integer`): Skip artists with fewer than this many followers. 0 keeps everyone. ## `withEmailOnly` (type: `boolean`): Output only artists that have at least one email (from the bio or, if enrichment is on, their website). Tightens the result set to ready-to-contact leads. ## `monitorMode` (type: `boolean`): Remember what was already returned and emit ONLY records not seen in previous runs (new artists for a search, new tracks per artist, or new tracks for a search). Pairs with Apify Schedules to track changes over time. ## `monitorStoreName` (type: `string`): Named key-value store that holds the 'already seen' ids for monitoring mode. Use a different name per tracked target/query to keep their histories separate. Lowercase letters, digits and hyphens only. ## `clientId` (type: `string`): Optional override for the public SoundCloud web client\_id. Leave blank — the actor discovers a fresh one automatically. Only set this if results come back empty (SoundCloud rotated the key). ## `maxConcurrency` (type: `integer`): Maximum parallel requests. Lower it if you hit rate limits on very large runs. ## `proxyConfiguration` (type: `object`): Proxy settings. SoundCloud's public API works fine through the default Apify datacenter proxy; switch to residential for very large or high-frequency runs. ## Actor input object example ```json { "mode": "searchArtists", "searchTerms": [ "lofi" ], "maxResultsPerQuery": 30, "includeWebProfiles": true, "includeTracks": false, "maxTracksPerArtist": 10, "includePlaylists": false, "maxPlaylistsPerArtist": 10, "enrichCreatorContacts": false, "minFollowers": 0, "withEmailOnly": false, "monitorMode": false, "monitorStoreName": "soundcloud-monitor", "maxConcurrency": 5, "proxyConfiguration": { "useApifyProxy": true } } ``` # Actor output Schema ## `results` (type: `string`): All scraped records in the default dataset. Artist rows carry full profile data, web profiles and creator-contact leads; track and playlist rows carry their own metadata. # 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 = { "searchTerms": [ "lofi" ] }; // Run the Actor and wait for it to finish const run = await client.actor("scrapesage/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 = { "searchTerms": ["lofi"] } # Run the Actor and wait for it to finish run = client.actor("scrapesage/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 '{ "searchTerms": [ "lofi" ] }' | apify call scrapesage/soundcloud-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=scrapesage/soundcloud-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "SoundCloud Scraper - Artists, Tracks & Creator Leads", "description": "Scrape SoundCloud: search artists & tracks, full creator profiles, tracks, albums & playlists, plus creator-contact leads (booking/management emails, socials, website). Followers, plays, genres, monitoring. No login, no API key, no browser.", "version": "0.1", "x-build-id": "SU4QJJuheLF46XkVu" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapesage~soundcloud-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapesage-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/scrapesage~soundcloud-scraper/runs": { "post": { "operationId": "runs-sync-scrapesage-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/scrapesage~soundcloud-scraper/run-sync": { "post": { "operationId": "run-sync-scrapesage-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": "What to scrape", "enum": [ "searchArtists", "artistDetails", "searchTracks" ], "type": "string", "description": "Pick a job. Search artists finds creators by keyword (full profiles + leads). Artist details pulls full profiles for specific artists (plus their tracks/playlists). Search tracks finds tracks by keyword.", "default": "searchArtists" }, "searchTerms": { "title": "Search terms", "type": "array", "description": "Keywords to search SoundCloud for, e.g. `lofi`, `techno producer`, `hip hop beats`, an artist name, or a genre. One row per term. Used by the Search artists and Search tracks modes.", "items": { "type": "string" } }, "artistUrls": { "title": "Artist URLs / permalinks / IDs", "type": "array", "description": "Artists to pull full details for: profile URLs (`https://soundcloud.com/flume`), bare permalinks (`flume`), or numeric user ids (`2976616`). One per row. (Mode: Artist details.)", "items": { "type": "string" } }, "maxResultsPerQuery": { "title": "Max results per search term", "minimum": 1, "maximum": 200, "type": "integer", "description": "Cap the number of artists (or tracks) returned per search term. Results are paginated automatically until this limit or the result set is exhausted.", "default": 30 }, "includeWebProfiles": { "title": "Include web profiles (socials + website)", "type": "boolean", "description": "Fetch each artist's linked profiles — Instagram, Twitter/X, Facebook, YouTube, Spotify, their own website and more (one extra request per artist). This is the main lead wedge alongside the booking/management email in the bio.", "default": true }, "includeTracks": { "title": "Include artist tracks", "type": "boolean", "description": "For artist modes, also output recent track records (type `track`) for each artist — title, genre, plays, likes, duration, release date and more. In monitoring mode this returns only NEW tracks since the last run.", "default": false }, "maxTracksPerArtist": { "title": "Max tracks per artist", "minimum": 1, "maximum": 100, "type": "integer", "description": "How many recent tracks to pull per artist when 'Include artist tracks' is on.", "default": 10 }, "includePlaylists": { "title": "Include artist playlists & albums", "type": "boolean", "description": "For artist modes, also output playlist/album records (type `playlist`) for each artist — title, track count, genre, release date and more.", "default": false }, "maxPlaylistsPerArtist": { "title": "Max playlists per artist", "minimum": 1, "maximum": 100, "type": "integer", "description": "How many playlists/albums to pull per artist when 'Include artist playlists & albums' is on.", "default": 10 }, "enrichCreatorContacts": { "title": "Enrich creator contacts (crawl website for emails, phone, socials)", "type": "boolean", "description": "Opt-in lead enrichment: visit each artist's own public website (home + a contact/about page) and extract contact emails, phone numbers and social links — for A&R, sync licensing, distribution, PR and booking outreach. Only runs for artists that list a website.", "default": false }, "minFollowers": { "title": "Minimum followers", "minimum": 0, "type": "integer", "description": "Skip artists with fewer than this many followers. 0 keeps everyone.", "default": 0 }, "withEmailOnly": { "title": "Only artists with an email", "type": "boolean", "description": "Output only artists that have at least one email (from the bio or, if enrichment is on, their website). Tightens the result set to ready-to-contact leads.", "default": false }, "monitorMode": { "title": "Monitoring mode — only new records", "type": "boolean", "description": "Remember what was already returned and emit ONLY records not seen in previous runs (new artists for a search, new tracks per artist, or new tracks for a search). Pairs with Apify Schedules to track changes over time.", "default": false }, "monitorStoreName": { "title": "Monitor store name", "type": "string", "description": "Named key-value store that holds the 'already seen' ids for monitoring mode. Use a different name per tracked target/query to keep their histories separate. Lowercase letters, digits and hyphens only.", "default": "soundcloud-monitor" }, "clientId": { "title": "SoundCloud client_id (optional)", "type": "string", "description": "Optional override for the public SoundCloud web client_id. Leave blank — the actor discovers a fresh one automatically. Only set this if results come back empty (SoundCloud rotated the key)." }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "Maximum parallel requests. Lower it if you hit rate limits on very large runs.", "default": 5 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy settings. SoundCloud's public API works fine through the default Apify datacenter proxy; switch to residential for very large or high-frequency runs.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } } ```