# SoundCloud Scraper - Tracks, Artists, Playlists & Comments (`scrapersdelight/soundcloud-scraper`) Actor

Scrape SoundCloud tracks, artists, playlists, albums, comments, followers, likes, reposts and charts: plays, likes, reposts, genre, tags, ISRC, label, artist followers, bio emails and social links. Search past the 300-result cap. No login, no API key.

- **URL**: https://apify.com/scrapersdelight/soundcloud-scraper.md
- **Developed by:** [Scrapers Delight](https://apify.com/scrapersdelight) (community)
- **Categories:** Social media, Lead generation, Videos
- **Features:** Limited permissions
- **Stats:** 1 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$0.45 / 1,000 results

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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

### What does SoundCloud Scraper do?

**SoundCloud Scraper** extracts SoundCloud data from [soundcloud.com](https://soundcloud.com) and turns search terms, links, artists and charts into structured rows: one row per track, artist, playlist/album or comment, with plays, likes, reposts, genre, tags, ISRC, label, the uploader's followers, and artist contacts. Built for A\&R scouts, music marketers, labels and data teams who need SoundCloud data without copying it by hand.

SoundCloud scraper · SoundCloud API alternative · SoundCloud track scraper · SoundCloud artist scraper · SoundCloud followers scraper · SoundCloud comments scraper

- **18 modes in one actor:** search tracks, artists, playlists or albums; any SoundCloud URL; an artist's tracks, popular tracks, playlists, albums, likes, reposts, followers and followings; a track's comments, likers, reposters and related tracks; Top 50, Trending and Trending-by-genre charts
- **Past the 300-result search limit:** SoundCloud stops every search at 300 results. Deep search re-runs a track search across SoundCloud's own length and upload-date filters and removes duplicates: `techno` returned **4,276 unique tracks** in one run (measured 2026-10-14)
- **Artist contacts included:** emails written in the bio, the artist's own website and Instagram, X, YouTube, Spotify, TikTok, Facebook, Bandcamp and Apple Music links, at no extra charge
- **Rights and release data:** ISRC, UPC/EAN, label, publisher artist, album and release title, writer/composer, P-line and C-line on every track that publishes them
- **No login, cookies or SoundCloud API key:** the actor reads SoundCloud's public web API the way the website does
- **Only new results:** monitor mode remembers what earlier runs delivered, so a daily schedule becomes a feed of new tracks, comments, followers or chart entries
- **Export anywhere:** JSON, CSV, Excel, XML or RSS; schedules, webhooks, Make, Zapier, n8n, Google Sheets, Slack; the Apify API and MCP server for AI agents

### What data can you get from SoundCloud?

<table>
<tr><td>🎵 Title, URL, artwork</td><td>▶️ Plays (<code>playbackCount</code>)</td><td>❤️ Likes, reposts, comments, downloads</td></tr>
<tr><td>🏷️ Genre and tags (<code>tagList</code>)</td><td>⏱️ Length (<code>duration</code>, <code>durationFormatted</code>)</td><td>📅 Uploaded, released, modified</td></tr>
<tr><td>💿 ISRC, UPC/EAN, label</td><td>✍️ Writer/composer, P-line, C-line</td><td>⚖️ License, policy, monetization</td></tr>
<tr><td>👤 Uploader, followers, verified, city, country</td><td>📈 Plays per day, engagement rate</td><td>🔊 Stream resources, waveform URL</td></tr>
<tr><td>🧑‍🎤 Artist bio, followers, tracks, playlists</td><td>📧 Bio emails (<code>emails</code>)</td><td>🌐 Website, Instagram, X, YouTube, Spotify, TikTok</td></tr>
<tr><td>📀 Playlist/album, set type, full tracklist</td><td>💬 Comment text, time in track, commenter</td><td>📊 Chart, genre, country, rank, score</td></tr>
</table>

### How to scrape SoundCloud with SoundCloud Scraper

1. [Sign up for a free Apify account](https://console.apify.com/sign-up) (it comes with monthly free credit).
2. Open **SoundCloud Scraper** and pick a mode in **What to scrape**, e.g. *Search tracks*.
3. Type your search terms, or paste SoundCloud links, handles or ids into **Start URLs**.
4. Set **Max results (total)** and any filters, then click **Start**.
5. Download the rows as JSON, CSV or Excel from the **Output** tab, or read them through the API.

The form runs as it opens: one search for `lofi hip hop` that returned 20 tracks from 2 requests in 2.3 seconds in a local test.

### ⬇️ Input

| Parameter | Type | Description |
|---|---|---|
| **🔍 What to scrape** | | |
| `mode` | string | `searchTracks` (default), `searchUsers`, `searchPlaylists`, `searchAlbums`, `urls`, `userTracks`, `userTopTracks`, `userPlaylists`, `userAlbums`, `userLikes`, `userReposts`, `followers`, `followings`, `trackComments`, `trackLikers`, `trackReposters`, `relatedTracks`, `charts` |
| `searchQueries` | array | Search terms, one search each. Used by the search modes. |
| `startUrls` | array | Any SoundCloud link, a handle (`skrillex`) or an id (`track:1207105309`, `user:856062`, `playlist:1571965048`). In artist and track modes, the artist or track whose list to read. |
| **🎯 Search filters** (sent to SoundCloud) | | |
| `genreOrTag` | string | Genre or tag, e.g. `techno`. Track, playlist and album searches. |
| `durationFilter` | string | `any`, `short` (<2 min), `medium` (2-10), `long` (10-30), `epic` (>30). Track searches. |
| `uploadedWithin` | string | `any`, `last_hour`, `last_day`, `last_week`, `last_month`, `last_year`. |
| `license` | string | `any`, `to_share`, `to_use_commercially`, `to_modify_commercially`. Track searches. |
| `place` | string | Artist location, e.g. `Berlin`. Artist searches. |
| `deepSearch` | boolean | Go past SoundCloud's 300-results-per-search limit (track searches). Default `false`. |
| `chartType` | string | `trending` (default), `top` (Top 50 by genre and country), `trendingByGenre`. |
| `chartGenres` | array | Chart genres (see *Read the charts* below). |
| `chartRegion` | string | Top 50 country: `US` (default), `GB`, `DE`, `FR`, `CA`, `AU`, `NL`, `IE`. |
| **✂️ Refine results** (checked before a row is saved) | | |
| `minPlays` | integer | Track rows with at least this many plays. |
| `minFollowers` / `maxFollowers` | integer | Artist rows: their followers. Other rows: the uploader's or commenter's followers. |
| `verifiedOnly` | boolean | Only verified artists / uploaders. |
| `countryCodes` | array | Artist / uploader country, e.g. `["US","GB"]`. |
| `withEmailOnly` | boolean | Only artists that publish an email. |
| `createdAfter` / `createdBefore` | string | Date (`2026-01-01`) or relative (`30 days`) for tracks, playlists and comments. |
| **➕ Extra data** (no extra charge) | | |
| `includeContacts` | boolean | Artist rows get bio emails, website and social links. Default `true`. |
| `expandPlaylistTracks` | boolean | Also save each playlist's tracks as track rows. Default `false`. |
| `includeComments` / `maxCommentsPerTrack` | boolean / integer | Newest comments attached to each track row (default 10). |
| `includeStreamUrls` | boolean | Resolve a playable stream URL per track (signed, short-lived). |
| `includeWaveform` | boolean | Attach the 1,800-point waveform. |
| **🔁 Monitoring** | | |
| `monitorMode` | boolean | Deliver only rows earlier runs with the same input did not deliver. |
| `monitorStoreName` | string | Name of the memory store. Default `soundcloud-scraper-monitor`. |
| **📦 Output** | | |
| `maxResults` | integer | Total rows for the run. Default `100`, `0` = no limit. |
| `maxResultsPerSource` | integer | Cap per search term or URL. `0` = only the total applies. |
| `dedupe` | boolean | Each track / artist / playlist / comment once per run. Default `true`. |
| `compact` | boolean | Core fields only, for AI and MCP pipelines. |
| `includeRawData` | boolean | Add SoundCloud's full JSON record as `raw`. |
| **⚙️ Advanced** | | |
| `clientId` | string | Optional. The actor reads SoundCloud's current public client_id itself on every run. |
| `proxyConfiguration` | object | Direct requests first; the proxy is used only if SoundCloud refuses them. |
| `maxConcurrency` | integer | Requests in flight. Default `8`. |

#### Input JSON

```json
{
    "mode": "searchTracks",
    "searchQueries": ["deep house", "melodic techno"],
    "uploadedWithin": "last_month",
    "minPlays": 1000,
    "maxResults": 500
}
```

#### Pick the mode first

Search modes take `searchQueries`; every other mode takes `startUrls`. **Any SoundCloud URL** mode detects what each link is: a track gives a track row, an artist gives an artist row, a playlist or album gives a playlist row with its full tracklist, a search page gives its results, `/discover` gives SoundCloud's Buzzing and Curated playlists, `/discover/sets/trending-by-genre:trap` gives that chart, `/tags/techno` gives the newest tracks with that tag, and `/skrillex/followers` or `/flume/say-nothing-feat-may-a/comments` give that list. Share links (`on.soundcloud.com/...`) and private links with a secret token work too.

#### Get past the 300-result search limit

SoundCloud returns at most 300 results for one search, whatever the site says the total is. Turn on **Deep search** and set **Max results** above 300: the same term is searched again inside each length and upload-date slice SoundCloud offers (up to 24 slices) and every track is saved once. `techno` reached 4,276 unique tracks in a 54-second local test run. Artist, playlist and album searches stay at 300 per term, so split them into more specific terms.

#### Find artists with contacts

Use **Search artists** (or **Artist's followers**, **Track likers**) with `withEmailOnly`, `minFollowers` and `countryCodes`. Every artist row carries the emails written in the bio and the links on the profile. Measured on 200 artists from five searches: 117 list profile links; of those, 60% link YouTube, 60% Instagram, 52% Facebook, 38% their own website, 33% Spotify, 33% X, 15% TikTok, 15% Apple Music.

#### Read the charts

**Top 50** exists for country, electronic, house, indie, pop, reggae, reggaeton, rock and techno in US, GB, DE, FR, CA, AU, NL and IE (100 tracks each). **Trending** covers all music (100 tracks). **Trending by genre** covers 20 genres such as trap, hip-hop, r-n-b, dubstep, ambient (50 tracks each). A genre SoundCloud does not publish for the chosen chart is reported in the log and the run summary, not charged.

### ⬆️ Output

Every row has `type` (`track`, `user`, `playlist`, `comment`) plus `source`, `sourceType`, `rank` and `scrapedAt`. A track row from a real run (trimmed):

```json
{
    "type": "track",
    "id": 1207105309,
    "title": "Say Nothing (feat. MAY-A)",
    "url": "https://soundcloud.com/flume/say-nothing-feat-may-a",
    "genre": "Electronic",
    "durationFormatted": "3:53",
    "playbackCount": 899269,
    "likesCount": 16931,
    "repostsCount": 901,
    "commentCount": 251,
    "createdAt": "2022-01-31T13:43:49Z",
    "labelName": "Future Classic",
    "isrc": "AUFF02200002",
    "publisherArtist": "Flume",
    "license": "all-rights-reserved",
    "userName": "Flume",
    "userFollowersCount": 2228473,
    "userVerified": true,
    "userCountryCode": "AU",
    "playsPerDay": 523.89,
    "engagementRate": 0.02011
}
```

An artist row with contacts (trimmed):

```json
{
    "type": "user",
    "username": "Clubstone",
    "url": "https://soundcloud.com/clubstone",
    "followersCount": 1911,
    "emails": ["booking@clubstone.de"],
    "website": "http://www.clubstone.de/",
    "instagram": "https://www.instagram.com/clubstone.music/",
    "verified": false,
    "plan": "free"
}
```

A comment row (trimmed):

```json
{
    "type": "comment",
    "body": "Nobody is Home ...",
    "createdAt": "2025-12-26T23:15:44Z",
    "timestampFormatted": "0:09",
    "userName": "KURBÆ DE LA ROX",
    "userCity": "Los Angeles",
    "trackUrl": "https://soundcloud.com/flume/say-nothing-feat-may-a"
}
```

#### Fields and how often SoundCloud fills them

Measured on 357 track, 231 artist, 25 playlist and 55 comment rows captured 2026-10-14 (searches, artist lists, charts, related tracks). A field below 100% is one that some uploaders leave empty; it is `null`, never a made-up value.

| Row | Field | Filled |
|---|---|---|
| track | `title`, `url`, `duration`, `createdAt`, `license`, `userName`, `userFollowersCount`, `streams`, `waveformUrl` | 100% |
| track | `playbackCount`, `likesCount`, `commentCount`, `downloadCount` | 99% |
| track | `artworkUrl` | 97% |
| track | `genre` | 82% |
| track | `tagList` / `description` | 49% / 56% |
| track | `isrc` / `labelName` / `upcOrEan` | 48% / 34% / 21% |
| track | `userCity` / `userCountryCode` | 58% / 46% |
| artist | `username`, `url`, `followersCount`, `trackCount`, `verified`, `plan` | 100% |
| artist | `description` (bio) / `fullName` | 61% / 66% |
| artist | `city` / `countryCode` | 46% / 37% |
| artist | `emails` (bio) | 19% |
| playlist | `title`, `url`, `trackCount`, `likesCount`, `userName`, `tracks` | 96-100% |
| comment | `body`, `createdAt`, `timestamp`, `userName`, `trackUrl` | 100% |

Stream URLs, waveform samples and comment samples were filled on 15 of 15, 15 of 15 and 14 of 14 commented tracks in a test run.

### Use cases

- 🎧 **A\&R and talent scouting:** search a genre, keep tracks with `minPlays` and artists under `maxFollowers`, sort by `playsPerDay`.
- 📣 **Music marketing and outreach:** artist rows with bio emails, website and socials for promo, booking and collaboration lists.
- 💿 **Catalogue and rights work:** ISRC, UPC, label and P/C-lines to match SoundCloud uploads to your releases.
- 📊 **Chart and trend tracking:** schedule the Top 50 or Trending charts daily and keep the history.
- 💬 **Fan research:** every comment on a track, with the moment in the track it was left.
- 🤝 **Audience mapping:** an artist's followers or a track's likers and reposters, with their own follower counts and locations.

### How much does it cost to scrape SoundCloud?

One price for every row type: **$0.45 per 1,000 results ($0.00045 per row)**. No start fee. Filtered rows, duplicates and rows already seen by monitor mode are never saved and never charged; contacts, comments, stream URLs and waveforms cost nothing extra.

| Rows | Price |
|---|---|
| 20 (the form as it opens) | $0.009 |
| 100 | $0.045 |
| 1,000 | $0.45 |
| 10,000 | $4.50 |

Apify's free plan credit covers thousands of rows a month. Set **Max results** or Apify's maximum total charge to cap a run; the actor stops exactly there.

### Integrations, API, scheduling & MCP

- **Schedules:** run daily or hourly in Apify Schedules; with **Only new results** each run returns only what is new.
- **Webhooks and apps:** send each finished dataset to Make, Zapier, n8n, Google Sheets, Slack, Airtable or your own endpoint.
- **API:** start runs and read rows with the [Python](https://docs.apify.com/api/client/python) or [JavaScript](https://docs.apify.com/api/client/js) client, or plain HTTP.
- **AI agents:** add the actor to Claude, Cursor or any MCP client through Apify's MCP server and ask for SoundCloud data in plain language; **Compact rows** keeps the answer small.

### More scrapers from ScrapersDelight

- 📺 [YouTube Channel Scraper](https://apify.com/scrapersdelight/youtube-channel-scraper): subscribers and channel data for the same artists on YouTube.
- 💬 [YouTube Comments Scraper](https://apify.com/scrapersdelight/youtube-comments-scraper): comments, replies and authors on music videos.
- 🔎 [YouTube Search Scraper](https://apify.com/scrapersdelight/youtube-search-scraper): videos and channels by keyword.
- 🎵 [TikTok Profile Scraper](https://apify.com/scrapersdelight/tiktok-profile-scraper): followers, bio and stats of the artists' TikTok accounts.
- 💭 [TikTok Comments Scraper](https://apify.com/scrapersdelight/tiktok-comments-scraper): comments, likes and commenters on TikTok videos.
- 🎙️ [Podcast Transcript Scraper](https://apify.com/scrapersdelight/podcast-transcript-scraper): any podcast RSS feed to text.

[All ScrapersDelight actors](https://apify.com/scrapersdelight)

### Limits & empty runs

- **300 results per search term** is SoundCloud's own limit; Deep search lifts it for track searches only.
- Artist likes, reposts and playlists return what the artist made public (Skrillex: 18 likes, 42 reposts).
- A search with no matches, a deleted or private link, or a chart genre SoundCloud does not publish ends with 0 rows and $0 charged; the reason is in the log and the `RUN_SUMMARY` record of the run's key-value store.
- Stream URLs expire a few hours after the run (`streamExpiresAt`); tracks that only allow a preview (`policy: SNIP`) get none. The actor never downloads audio.
- Requests go direct; if SoundCloud refuses them the run switches to a proxy by itself.

### ❓ FAQ

#### How much does SoundCloud Scraper cost?

$0.00045 per saved row ($0.45 per 1,000), with no start fee and nothing charged for filtered, duplicate or empty results.

#### How many results can SoundCloud Scraper get?

Up to 300 per search term (SoundCloud's limit), thousands per term with Deep search, and full lists for artist tracks, followers, followings, likers, reposters and comments (5,000 followers of one artist were read in 28 seconds in a local test run). Set `maxResults` to `0` for no cap.

#### Can SoundCloud Scraper monitor new tracks or comments on a schedule?

Yes. Turn on **Only new results**, keep the same input, and schedule the run; each run delivers only rows earlier runs did not.

#### Can I use SoundCloud Scraper with the Apify API?

Yes. Start a run with the input JSON above and read the dataset with the Apify API, the Python client or the JavaScript client.

#### Can I use SoundCloud Scraper through an MCP server?

Yes. Add it to your AI client through Apify's MCP server; turn on **Compact rows** for shorter answers.

#### Do I need a SoundCloud account, login or API key to use SoundCloud Scraper?

No. The actor reads SoundCloud's public web API with the public client_id the site itself uses, refreshed on every run.

#### Does SoundCloud Scraper get artist emails?

It returns the emails an artist writes in their bio or profile links, exactly as written, and their website and social links. It never guesses an email.

#### Why did SoundCloud Scraper return no results?

The search had no matches, the link was deleted or private, your filters removed every row, or the chart genre is not published for that chart. The log line for each source says which, and none of it is charged.

#### Can SoundCloud Scraper download MP3s or transcribe tracks?

No. It returns metadata, and with **Stream URLs** on, SoundCloud's own short-lived playback link. It does not download audio or transcribe it.

#### Is it legal to scrape SoundCloud?

SoundCloud Scraper collects publicly available track, artist, playlist, comment and chart data, the same data soundcloud.com shows any visitor. Review SoundCloud's terms and the law that applies to your use.

#### Your feedback

Found a bug or need another field or mode? Open an issue on the actor's **Issues** tab and we will look at it.

# Actor input Schema

## `mode` (type: `string`):

Search SoundCloud, read any SoundCloud URL, read an artist's or a track's lists, or read the charts. Search and URL modes also accept Start URLs.

## `searchQueries` (type: `array`):

One search per line, for the search modes, e.g. "lofi hip hop", "deep house", "Skrillex". Each term is searched separately.

## `startUrls` (type: `array`):

SoundCloud links of any kind: track, artist, playlist or album, search page, /discover, on.soundcloud.com share link, a handle ("skrillex") or an id ("track:1207105309"). In artist and track modes, the artist or track whose list to read.

## `genreOrTag` (type: `string`):

SoundCloud's own search filter, e.g. "techno" or "lo-fi". Applies to track, playlist and album searches.

## `durationFilter` (type: `string`):

Track searches only.

## `uploadedWithin` (type: `string`):

Track, playlist and album searches.

## `license` (type: `string`):

Track searches only: Creative Commons licences that allow the use you pick.

## `place` (type: `string`):

Artist searches only: a city or country, e.g. "Berlin".

## `deepSearch` (type: `boolean`):

SoundCloud stops every search at 300 results. On, a track search is re-run across SoundCloud's length and upload-date filters and de-duplicated, reaching thousands of tracks per term.

## `chartType` (type: `string`):

Charts mode only. Top 50 is per genre and country; Trending is all music; Trending by genre is SoundCloud's 20 trending playlists.

## `chartGenres` (type: `array`):

Charts mode. Top 50 has: country, electronic, house, indie, pop, reggae, reggaeton, rock, techno. Trending by genre has 20, e.g. trap, hip-hop, r-n-b, dubstep, ambient.

## `chartRegion` (type: `string`):

Top 50 charts only.

## `minPlays` (type: `integer`):

Track rows only. 0 = no minimum.

## `minFollowers` (type: `integer`):

Artist rows: their followers. Track, playlist and comment rows: the uploader's or commenter's followers. 0 = no minimum.

## `maxFollowers` (type: `integer`):

Same rule as minimum followers, e.g. 50000 to find emerging artists. 0 = no maximum.

## `verifiedOnly` (type: `boolean`):

Keep only rows whose artist (or uploader) carries SoundCloud's verified badge.

## `countryCodes` (type: `array`):

Two-letter codes, e.g. "US", "GB", "DE". Keeps rows whose artist (or uploader) lists one of these countries.

## `withEmailOnly` (type: `boolean`):

Artist rows only: keep artists whose bio or profile links publish an email.

## `createdAfter` (type: `string`):

Tracks, playlists and comments created on or after this date, e.g. "2026-01-01" or "30 days".

## `createdBefore` (type: `string`):

Tracks, playlists and comments created on or before this date.

## `includeContacts` (type: `boolean`):

Artist rows: emails from the bio plus the profile's website and social links (Instagram, X, YouTube, Spotify, TikTok, Facebook...). One extra request per artist, no extra charge.

## `expandPlaylistTracks` (type: `boolean`):

After each playlist or album row, also save each of its tracks as its own track row (each is a result). Playlist rows always carry the full tracklist.

## `includeComments` (type: `boolean`):

Attach the newest comments to each track row. For every comment as its own row, use Track comments mode.

## `maxCommentsPerTrack` (type: `integer`):

How many comments to attach when Comments on track rows is on.

## `includeStreamUrls` (type: `boolean`):

Resolve each track's playable stream URL (signed; expires a few hours after the run; HLS, or MP3 when the track publishes one).

## `includeWaveform` (type: `boolean`):

Attach each track's 1,800-point waveform as a number array.

## `monitorMode` (type: `boolean`):

Deliver only rows that earlier runs with the same input did not deliver. Pairs with a daily schedule.

## `monitorStoreName` (type: `string`):

Named key-value store that remembers delivered rows. Use a different name per watch list.

## `maxResults` (type: `integer`):

Total rows this run saves across all sources. A search stops at 300 per term unless Deep search is on. 0 = no limit.

## `maxResultsPerSource` (type: `integer`):

Cap for each search term or URL so one source cannot use the whole run. 0 = only the total cap applies.

## `dedupe` (type: `boolean`):

Save each track, artist, playlist or comment once per run, even when two sources return it.

## `compact` (type: `boolean`):

Core fields only (title, URL, artist, plays, likes, dates...), trimmed for AI and MCP pipelines.

## `includeRawData` (type: `boolean`):

Add SoundCloud's full JSON record to each row as raw.

## `clientId` (type: `string`):

Optional. The actor reads SoundCloud's current public client_id by itself on every run; set one only to force it.

## `proxyConfiguration` (type: `object`):

Requests go direct first. If SoundCloud refuses them, the run switches to the Apify proxy (Residential unless you pick a group) or to your own proxy URLs.

## `maxConcurrency` (type: `integer`):

Requests in flight at once.

## Actor input object example

```json
{
  "mode": "searchTracks",
  "searchQueries": [
    "lofi hip hop"
  ],
  "durationFilter": "any",
  "uploadedWithin": "any",
  "license": "any",
  "deepSearch": false,
  "chartType": "trending",
  "chartRegion": "US",
  "verifiedOnly": false,
  "withEmailOnly": false,
  "includeContacts": true,
  "expandPlaylistTracks": false,
  "includeComments": false,
  "maxCommentsPerTrack": 10,
  "includeStreamUrls": false,
  "includeWaveform": false,
  "monitorMode": false,
  "monitorStoreName": "soundcloud-scraper-monitor",
  "maxResults": 20,
  "maxResultsPerSource": 0,
  "dedupe": true,
  "compact": false,
  "includeRawData": false,
  "proxyConfiguration": {
    "useApifyProxy": false
  },
  "maxConcurrency": 8
}
```

# Actor output Schema

## `results` (type: `string`):

One item per track, artist, playlist or comment.

## `summary` (type: `string`):

Per-source counts, not-found and unreachable inputs, and why the run stopped.

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "mode": "searchTracks",
    "searchQueries": [
        "lofi hip hop"
    ],
    "maxResults": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("scrapersdelight/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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "mode": "searchTracks",
    "searchQueries": ["lofi hip hop"],
    "maxResults": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("scrapersdelight/soundcloud-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).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": "searchTracks",
  "searchQueries": [
    "lofi hip hop"
  ],
  "maxResults": 20
}' |
apify call scrapersdelight/soundcloud-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,scrapersdelight/soundcloud-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/iLD3Da87Ct4pyp8kM/builds/jVHzljYfqIIW5mUVt/openapi.json
