# SoundCloud Scraper: Tracks, Plays, Artists and Playlists (`themineworks/soundcloud-scraper`) Actor

Scrape SoundCloud tracks, playlists, albums and artists by keyword or link: plays, likes, reposts, comments, duration, genre, tags, release date, label, ISRC, artwork and link, plus artist followers and track count, and the trending top 100. No login, no audio downloads.

- **URL**: https://apify.com/themineworks/soundcloud-scraper.md
- **Developed by:** [The Mine Works](https://apify.com/themineworks) (community)
- **Categories:** Social media, Marketing, Automation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.08 / 1,000 items

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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

## SoundCloud Scraper: Tracks, Plays, Artists and Playlists

[![30 SoundCloud tracks with plays, likes, reposts and artist followers in 3 seconds](https://api.apify.com/v2/key-value-stores/cUXz95yxflDho41nn/records/soundcloud-scraper-hero.png)](https://console.apify.com/actors/KQy2u8RuJEOE467kX/input?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

Returns SoundCloud tracks, playlists, albums and artists by keyword or link, one row per item with plays, likes, reposts, comments, duration, genre, tags, upload and release date, label, ISRC, artwork and link, and artist rows with followers, track count, verified badge and location. The trending top 100 is one switch away. No login, no cookies, no API key. You pay $2.07 per 1,000 items on the Free plan and $1.08 per 1,000 on the Gold plan, plus a $0.003 start fee per run.

**Part of The Mine Works Social media and video family:** [Threads Scraper](https://apify.com/themineworks/threads-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Reddit Scraper](https://apify.com/themineworks/reddit-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Threads Search Scraper](https://apify.com/themineworks/threads-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Instagram Profile Scraper](https://apify.com/themineworks/instagram-profile-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Instagram Followers & Following](https://apify.com/themineworks/instagram-followers-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Reddit Search Scraper](https://apify.com/themineworks/reddit-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral).

Updated 17 Nov 2026: first release. Track, artist, playlist and album search, track search filters (genre or tag, upload date, length, license), track searches past SoundCloud's 300 result limit, track, playlist, album, artist and search links, artist tracks, popular tracks, sets and albums, playlist tracks, artist website and social links, and the trending chart, one flat row per item. Bookmark this Actor on its Store page so it is one click away next time.

### Why choose this actor?

- **The numbers a label or promoter compares, in columns.** Every track row carries `plays`, `likes`, `reposts`, `comments` and `downloads` as numbers, next to the artist's `artist_followers` and `artist_track_count`, so a whole search sorts by engagement in a spreadsheet with no extra lookups. Release metadata comes along when the distributor set it: `isrc` was filled on 379 of 1,151 tracks in our test runs, `label_name`, `publisher`, `p_line` and `upc` too.
- **More than 300 results per search.** SoundCloud ends every search at 300 results. When you ask for more tracks, the actor asks again per length band and per upload age and drops repeats, so `maxItems: 500` returned 500 tracks for "techno" in our test.
- **Pay per item, nothing for errors.** $2.07 per 1,000 on the Free plan, about 10% under the Store leader. Links that are not SoundCloud items, deleted tracks, duplicates and the summary row are never charged. No audio is downloaded: rows are metadata and links only.

[![Run it on Apify](https://api.apify.com/v2/key-value-stores/cUXz95yxflDho41nn/records/button-run.png)](https://console.apify.com/actors/KQy2u8RuJEOE467kX/input?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

### Try it in one minute

Paste this into the input (JSON view) and press Start. It returns the first 30 tracks for "lofi hip hop". It took 3 seconds in our test run on Apify:

```json
{
  "searchQueries": ["lofi hip hop"],
  "maxItems": 30
}
```

Put several keywords on separate lines to run several searches at once, switch `searchType` to `users`, `playlists` or `albums`, or paste SoundCloud links into `startUrls`. An item that two of your inputs find is delivered once.

Apify's free plan includes $5 of credit every month, which covers about 2,400 items at this actor's price.

#### Copy to your AI assistant

```text
themineworks/soundcloud-scraper on Apify. Searches SoundCloud by keyword or reads SoundCloud links and returns one flat row per track, playlist, album or artist, with no login. Call ApifyClient("TOKEN").actor("themineworks/soundcloud-scraper").call(run_input={"searchQueries": ["lofi hip hop"], "maxItems": 100}), then client.dataset(run["defaultDatasetId"]).list_items().items. Inputs: searchQueries (list of keywords), searchType (tracks, users, playlists or albums; default tracks), startUrls (list of soundcloud.com track, playlist, album, artist, artist /tracks, /popular-tracks, /sets, /albums, search links or on.soundcloud.com short links), maxItems (default 50, 1 to 5000, per keyword or link), includeArtistTracks (default true), includePlaylistTracks (default false), includeArtistLinks (default false), trendingChart (default false, trending top 100), and track search filters genreOrTag, uploadedWithin (last_hour, last_day, last_week, last_month, last_year), duration (short, medium, long, epic), license (to_share, to_use_commercially, to_modify_commercially). Item rows have no _type field; type is track, playlist, album or artist. Track rows carry track_id, title, url, artist_id, artist_username, artist_name, artist_url, artist_followers, artist_track_count, artist_verified, artist_city, artist_country_code, plays, likes, reposts, comments, downloads, stats_hidden, duration_ms, duration, genre, tags, release_date, created_at, display_date, last_modified, artwork_url, description, label_name, isrc, upc, publisher_artist, album_title, release_title, explicit, publisher, writer_composer, p_line, c_line, license, downloadable, streamable, monetization_model, policy, purchase_url, waveform_url. Playlist and album rows carry playlist_id, set_type, is_album, track_count, track_ids, likes, reposts, duration, genre, tags, release_date, published_at, label_name. Artist rows carry artist_id, artist_username, artist_name, url, avatar_url, city, country_code, followers, followings, track_count, playlist_count, verified, is_pro, bio, links. Every row has source, position and scraped_at; search rows add query and search_type, trending rows add chart_rank and chart_score. Each run also writes one row with _type "summary", one with _type "info" when items were delivered, and a row with _type "error" for each input that could not be read; none of these is charged. Full spec: GET https://api.apify.com/v2/acts/themineworks~soundcloud-scraper/builds/default (Bearer TOKEN), which returns inputSchema and readme. Token: https://console.apify.com/account/integrations?fpr=ymnoit&utm_source=apify-readme&utm_medium=referral
```

### Key features

- **Four kinds of search.** Keywords search tracks by default; set `searchType` to `users` for artists, `playlists` or `albums`. Each keyword is its own search, labelled in `query`.
- **Track search filters.** `genreOrTag`, `uploadedWithin` (last hour to last year), `duration` (under 2 minutes, 2 to 10, 10 to 30, over 30) and `license` work the way the filters on soundcloud.com do.
- **Any SoundCloud link.** A track, a playlist or album, an artist profile, an artist's `/tracks`, `/popular-tracks`, `/sets` or `/albums` page, a search link or an `on.soundcloud.com` short link. Each is detected for you.
- **Artist profile plus tracks.** An artist link returns the profile row (followers, followings, track and playlist counts, verified, Pro, city, country, bio) and then the artist's tracks, newest first. Turn on `includeArtistLinks` for the website, Instagram, YouTube and other links shown on the profile.
- **Playlist and album tracks.** With `includePlaylistTracks` a playlist or album link returns one row per track in playlist order, each tagged with `from_playlist_id` and `from_playlist_title`.
- **Trending chart.** `trendingChart: true` adds SoundCloud's trending top 100 with `chart_rank` and `chart_score`.
- **Stops cleanly.** A deleted or private link gets an error row and costs nothing; six failed inputs in a row end the run; the run stops before its time limit and keeps every row. The summary row says why a search ended.

### How to use it

#### Basic: tracks for a keyword

```json
{
  "searchQueries": ["afro house"],
  "maxItems": 200
}
```

Sort by `plays` or `likes` to see what leads the genre, or by `created_at` for what is new.

#### New releases in a genre, past the 300 limit

```json
{
  "searchQueries": ["techno"],
  "uploadedWithin": "last_year",
  "maxItems": 500
}
```

The actor widens the search over length bands to pass SoundCloud's 300 result stop. In our test this returned 500 tracks in about 12 seconds.

#### Artist research for A\&R or bookings

```json
{
  "searchQueries": ["afro house"],
  "searchType": "users",
  "maxItems": 100,
  "includeArtistLinks": true
}
```

One row per artist with `followers`, `track_count`, `verified`, `city`, `country_code`, `bio` and, with `includeArtistLinks`, the website and social links on the profile.

#### Everything an artist has published

```json
{
  "startUrls": ["https://soundcloud.com/odesza", "https://soundcloud.com/odesza/albums"],
  "maxItems": 200
}
```

The profile row, up to 200 tracks, and the albums, EPs and singles with release dates and labels.

#### A playlist, track by track

```json
{
  "startUrls": ["https://soundcloud.com/forss/sets/soulhack"],
  "includePlaylistTracks": true
}
```

The album row, then one row per track with plays, likes, ISRC and release metadata.

#### Weekly trending report

```json
{
  "trendingChart": true,
  "maxItems": 100
}
```

### Input parameters

| Parameter | Type | Default | What it does |
|---|---|---|---|
| `searchQueries` | array of strings | empty | Keywords, one search each, for example `lofi hip hop`. |
| `searchType` | string | `tracks` | What keywords search: `tracks`, `users` (artists), `playlists` or `albums`. |
| `startUrls` | array of strings | empty | SoundCloud links: track, playlist, album, artist, artist `/tracks`, `/popular-tracks`, `/sets`, `/albums`, search, `on.soundcloud.com`. |
| `maxItems` | integer | `50` | Most rows per keyword or link, 1 to 5,000. An artist link's profile row is extra. |
| `includeArtistTracks` | boolean | `true` | Artist links also return the artist's tracks. |
| `includePlaylistTracks` | boolean | `false` | Playlist and album links also return one row per track. |
| `includeArtistLinks` | boolean | `false` | Artist rows get the website and social links on the profile. |
| `trendingChart` | boolean | `false` | Adds the trending top 100. |
| `genreOrTag` | string | empty | Track searches only: genre or tag. |
| `uploadedWithin` | string | empty | Track searches only: `last_hour`, `last_day`, `last_week`, `last_month`, `last_year`. |
| `duration` | string | empty | Track searches only: `short`, `medium`, `long`, `epic`. |
| `license` | string | empty | Track searches only: `to_share`, `to_use_commercially`, `to_modify_commercially`. |

Give `searchQueries`, `startUrls`, `trendingChart` or any mix. Up to 200 inputs per run.

### What data do you get?

One row per track, playlist, album or artist. Item rows have no `_type` field; the summary, info and error rows do, so a filter on `_type` separates them. `type` tells the kind of item.

| Field | What it is |
|---|---|
| `type` | `track`, `playlist`, `album` or `artist` |
| `title`, `url` | Title (the artist name on artist rows) and link |
| `track_id`, `playlist_id`, `artist_id` | SoundCloud ids |
| `artist_username`, `artist_name`, `artist_url` | The uploader: handle, name as shown, profile link |
| `artist_followers`, `artist_track_count`, `artist_verified`, `artist_city`, `artist_country_code` | The uploader's numbers and location, on track, playlist and album rows |
| `plays`, `likes`, `reposts`, `comments`, `downloads` | Counts as numbers |
| `stats_hidden` | True when the uploader hides play and like counts |
| `duration_ms`, `duration` | Length in milliseconds and as `m:ss` or `h:mm:ss` |
| `genre`, `tags` | Genre and tags set by the uploader |
| `created_at`, `release_date`, `display_date`, `published_at`, `last_modified` | Upload date, release date, the date SoundCloud shows, playlist publication date, last edit |
| `artwork_url`, `artwork_from_artist`, `artist_avatar_url` | Cover art at 500 x 500 (the artist picture when the track has none) |
| `description` | Text of the track, playlist or album |
| `label_name`, `isrc`, `upc`, `publisher_artist`, `album_title`, `release_title`, `explicit`, `publisher`, `writer_composer`, `p_line`, `c_line` | Release metadata, when the distributor set it |
| `license`, `downloadable`, `streamable`, `commentable`, `monetization_model`, `policy`, `embeddable_by` | Rights and availability |
| `purchase_url`, `purchase_title` | Buy or smart link set by the artist |
| `waveform_url` | Waveform data link |
| `set_type`, `is_album`, `track_count`, `track_ids` | Playlist and album rows: album, ep, single or plain playlist, track count and ids in order |
| `avatar_url`, `city`, `country_code`, `followers`, `followings`, `track_count`, `playlist_count`, `liked_tracks`, `liked_playlists`, `verified`, `is_pro`, `bio` | Artist rows |
| `links` | Artist rows with `includeArtistLinks`: `network`, `url`, `title` per link |
| `source`, `position` | How the row was found (`search`, `url`, `artist`, `playlist`, `trending`) and its place in that list |
| `query`, `search_type`, `search_url` | The search that found the row |
| `input_url`, `list`, `from_playlist_id`, `from_playlist_title`, `from_playlist_url` | The link that led to the row |
| `chart`, `chart_genre`, `chart_rank`, `chart_score`, `chart_updated_at` | Trending rows |
| `scraped_at` | When the row was written |

**Summary row** (`_type: "summary"`, never charged): `inputs_requested`, `inputs_read`, `inputs_failed`, `pages_read`, `items_found`, `items_delivered`, `charged_for`, `duplicates_skipped`, `tracks_delivered`, `playlists_delivered`, `artists_delivered`, `http_requests`, `ended_on_deadline`, `stopped_by_max_cost`, `shortfall_reason` when fewer items came back than asked, and `per_input`, one entry per keyword or link with `pages`, `items_found`, `items_delivered` and why it `stopped`. The same summary is saved as the `OUTPUT` record of the run.

**Error rows** (`_type: "error"`, never charged): one per input that could not be read, with `error_type` (`invalid_url`, `not_found`, `blocked`, `fetch_error`), `identifier`, `reason` and `http_status`.

#### Stable fields for automations

These were present in every track row of our test runs on Apify (1,151 tracks from 4 runs), and their names will not change:

| Field | What it is |
|---|---|
| `track_id` | The key to store and join on |
| `title`, `url` | Track title and link |
| `artist_id`, `artist_name`, `artist_url` | The uploader |
| `artist_followers` | Uploader's followers |
| `duration_ms` | Length |
| `created_at` | Upload date |
| `artwork_url` | Cover art |
| `license`, `streamable` | Rights |
| `source`, `position` | Where the row came from |

`plays`, `likes`, `reposts` and `comments` are numbers on every track whose uploader shows them (2 of 1,151 test tracks hid them: `stats_hidden: true`). Optional, present only when SoundCloud has a value: `genre` (935 of 1,151), `tags`, `description`, `isrc` (379), `release_date` (231), `label_name` (214), `artist_city`, `artist_country_code`, `purchase_url`. Artist `links` exist when the artist added any (18 of 41 artists in our test).

#### Output examples

One track from the "lofi hip hop" search (test run on Apify, 17 Nov 2026, trimmed):

```json
{
  "type": "track",
  "track_id": 482248920,
  "title": "Super Mario World Game Over Lo-Fi Hip Hop Remix",
  "url": "https://soundcloud.com/hephestosmusic/super-mario-world-game-over",
  "artist_name": "HephestosMusic",
  "artist_url": "https://soundcloud.com/hephestosmusic",
  "artist_followers": 2988,
  "artist_track_count": 75,
  "plays": 1584331,
  "likes": 24114,
  "reposts": 723,
  "comments": 801,
  "duration_ms": 238571,
  "duration": "3:59",
  "created_at": "2018-08-07T10:24:11Z",
  "artwork_url": "https://i1.sndcdn.com/artworks-000385408905-o0qzuy-t500x500.jpg",
  "isrc": "QZTAZ2208714",
  "release_title": "Game Over",
  "license": "all-rights-reserved",
  "monetization_model": "AD_SUPPORTED",
  "source": "search",
  "query": "lofi hip hop",
  "position": 2
}
```

An artist row from an artist link with `includeArtistLinks` (same day, trimmed):

```json
{
  "type": "artist",
  "artist_id": 203410014,
  "artist_name": "deadmau5",
  "url": "https://soundcloud.com/deadmau5",
  "city": "Toronto",
  "country_code": "CA",
  "followers": 398502,
  "followings": 3,
  "track_count": 407,
  "playlist_count": 80,
  "verified": true,
  "is_pro": true,
  "links": [
    { "network": "youtube", "url": "https://www.youtube.com/user/deadmau5", "title": "yt" },
    { "network": "facebook", "url": "https://www.facebook.com/deadmau5/", "title": "fb" }
  ],
  "source": "url",
  "position": 0
}
```

An album row (trimmed):

```json
{
  "type": "album",
  "playlist_id": 18,
  "title": "Soulhack",
  "url": "https://soundcloud.com/forss/sets/soulhack",
  "set_type": "album",
  "artist_name": "Forss",
  "track_count": 11,
  "likes": 1582,
  "reposts": 258,
  "duration": "54:07",
  "genre": "Electronic",
  "release_date": "2003-06-02T00:00:00Z",
  "label_name": "sonarkollektiv"
}
```

An error row for a link that is not a SoundCloud item (nothing charged):

```json
{ "_type": "error", "error_type": "not_found", "identifier": "https://soundcloud.com/nosuchuser-zz-9q8w7e6r/nosuchtrack", "reason": "SoundCloud has no public item at this link (deleted, private or mistyped).", "http_status": 404 }
```

### Pricing

Pay per event: you pay for the items you receive, plus a flat $0.003 per run, whatever memory you choose. Artist links, playlist tracks and the trending chart cost nothing extra.

| Event | When it is charged | Free plan | Bronze (Starter) | Silver (Scale) | Gold (Business) |
|---|---|---|---|---|---|
| `item-scraped` | Once per track, playlist, album or artist row stored in your dataset | $2.07 per 1,000 | $1.80 per 1,000 | $1.40 per 1,000 | $1.08 per 1,000 |
| `run-start` | Once per run, after the first input returned items | $0.003 | $0.003 | $0.003 | $0.003 |

The price of one item is the price per 1,000 divided by 1,000.

Never charged:

- links that are not SoundCloud items, and deleted or private links (each gets an error row);
- an item that a second input of the same run finds again;
- items past your `maxItems`;
- the summary, info and error rows;
- a run with no valid input, or one whose inputs return nothing: the start fee is charged only once an input has returned items;
- anything past your "Max cost per run". The actor checks the budget before each batch of rows and stops while the total is still below your limit, so the run ends SUCCEEDED with a partial result and a status message saying so.

### How it compares

| Actor | Price per 1,000 on the Free plan | Price per 1,000 on Gold | Start fee | Login or cookies needed | Past 300 results per search | Trending chart |
|---|---|---|---|---|---|---|
| **This actor** | $2.07 | $1.08 | $0.003 per run | None needed | Yes, track searches | Yes |
| [SoundCloud Scraper: Tracks, Artists, Playlists & Emails](https://apify.com/automation-lab/soundcloud-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) | $2.30 | $1.20 | $0.005 per run | No API key or login (stated) | Yes, track searches (stated) | Yes |
| [SoundCloud Scraper](https://apify.com/epctex/soundcloud-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) | $1.60 | $1.60 | $0.00005 per GB of memory | Proxy required (stated) | not stated | not stated |
| [SoundCloud Scraper: Tracks, Artists, Emails](https://apify.com/memo23/soundcloud-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) | $1.50, extra data $1.00 | $1.50 | $0.05 per GB of memory | No browser, no setup (stated) | not stated | not stated |

Checked 17 Nov 2026 from the public Store listings.

### Run it on a schedule

1. Open the actor in Apify Console, set your input and click **Save as a new task**.
2. In the task, open **Schedules**, click **Add schedule** and pick how often (every day, every Monday at 08:00 and so on).
3. Compare runs on `track_id` and `plays` to see which tracks are growing, or on `artist_id` and `followers` to follow artists week by week.
4. Optional: add an integration (Google Sheets, Slack, a webhook) so each run lands where your team works.

### FAQ

#### What does this actor read?

SoundCloud's public tracks, playlists, albums, artist profiles, search results and trending chart, through the same public web API the soundcloud.com player uses, as anyone sees them without logging in. It does not log in, does not download or stream audio, and does not read private tracks or secret links.

#### How many items can I get?

Up to 5,000 per keyword or link and 200 inputs per run. SoundCloud ends each search at 300 results; for track searches that ask for more, the actor repeats the search per length band and upload age to reach your number (500 for "techno" in our test). Artist, user and playlist searches stop at about 300, as on soundcloud.com.

#### Why do some tracks have no plays or likes?

The uploader chose to hide them (a SoundCloud Pro option). Those rows have `stats_hidden: true`. Reposts and the rest of the row are still there.

#### Why do some rows have no genre, ISRC or label?

Those fields are set by the uploader or the distributor. Tracks released through a distributor usually carry `isrc`, `label_name`, `p_line` and `release_date`; home uploads often do not.

#### Does it download the audio?

No. Rows are metadata and links only: title, counts, dates, artwork, waveform link and the track link.

#### Does it return artist emails?

No. It returns the profile text in `bio` as the artist wrote it, and with `includeArtistLinks` the website and social links the artist put on the profile.

#### How long does a run take?

In our tests on Apify: 3 seconds for the "Try it" input (30 tracks), 24 seconds for 1,000 tracks from 2 searches, 9 seconds for 197 rows from 8 mixed links with playlist tracks, artist links and the trending chart, 11 seconds for 120 playlists. The default time limit is 3,600 seconds; the actor stops before it and keeps every row.

#### Do I need an account, cookies or an API key?

No account, no cookies and no API key. The actor reads SoundCloud's public data directly. Nothing to set up.

#### Which actor should I use for other music and social platforms?

[Spotify Scraper](https://apify.com/themineworks/spotify-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) for Spotify, [TikTok Sounds Scraper](https://apify.com/themineworks/tiktok-sounds-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) for the sounds trending on TikTok, and [YouTube Channel Scraper](https://apify.com/themineworks/youtube-channel?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) for YouTube channels.

#### Which formats can I download?

JSON, CSV, Excel, XML, RSS and HTML from the run's Storage tab or through the API. The dataset has three ready views: Tracks, playlists and artists, Track details, and Artists. In CSV and Excel, `tags`, `track_ids` and `links` are flattened into columns such as `tags/0` and `links/0/url`.

#### Can I use it from Claude, ChatGPT or Cursor (MCP)?

Yes, through Apify's MCP server. Connector URL: https://mcp.apify.com/?tools=themineworks/soundcloud-scraper

- Claude: Settings > Connectors > Add custom connector, paste the URL, sign in with Apify.
- ChatGPT: turn on developer mode, add an MCP connector with the URL, sign in with Apify.
- Cursor or VS Code: add it as an HTTP MCP server with that URL.
- Claude Code: `claude mcp add -t http soundcloud-scraper "https://mcp.apify.com/?tools=themineworks/soundcloud-scraper"`

#### Is it legal to scrape SoundCloud?

The actor reads only public data that anyone can see on soundcloud.com without logging in: track and playlist pages and artist profiles that artists publish to be found. It does not copy audio. You are responsible for how you use the data, including SoundCloud's terms, copyright, and data protection law such as GDPR and CCPA. This is general information, not legal advice.

### Integrations

- **Google Sheets**: send each run's rows to a sheet with Apify's Google Sheets integration; one row per item fits a sheet as is.
- **Make, Zapier and n8n**: start a run and read its dataset with the Apify apps and nodes, for example "new tracks in our genre every Monday to Slack".
- **Webhooks**: have Apify call your URL when a run succeeds, then fetch the dataset.
- **API and SDKs**: run it from Python or JavaScript with the Apify client, or with a plain HTTP call (see "Copy to your AI assistant" above).
- **MCP clients**: Claude, ChatGPT, Cursor and VS Code can run it as a tool through the connector URL in the FAQ.

If this actor saved you time, a short rating on the Store helps other buyers find it.

### More from The Mine Works

**Social media and video**

- [Threads Scraper](https://apify.com/themineworks/threads-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Reddit Scraper](https://apify.com/themineworks/reddit-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Threads Search Scraper](https://apify.com/themineworks/threads-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Instagram Profile Scraper](https://apify.com/themineworks/instagram-profile-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Instagram Followers & Following](https://apify.com/themineworks/instagram-followers-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Reddit Search Scraper](https://apify.com/themineworks/reddit-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Twitter / X Scraper](https://apify.com/themineworks/twitter-x-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [YouTube Transcript](https://apify.com/themineworks/youtube-transcript-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Xiaohongshu (RED) Scraper](https://apify.com/themineworks/xiaohongshu-explore-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Telegram Channel Scraper](https://apify.com/themineworks/telegram-channel-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Telegram Channel Finder](https://apify.com/themineworks/telegram-channel-finder?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Pinterest Profile Scraper](https://apify.com/themineworks/pinterest-profile-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Leads and business directories**

- [B2B Leads Finder](https://apify.com/themineworks/b2b-leads-finder?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Skip Trace Lookup](https://apify.com/themineworks/skip-trace-lookup?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google Maps Email Scraper](https://apify.com/themineworks/maps-leads?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [2GIS Places Scraper](https://apify.com/themineworks/2gis-places-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Marketing, SEO and reviews**

- [Facebook Ad Library Scraper](https://apify.com/themineworks/meta-ad-library-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google Ads Transparency Scraper](https://apify.com/themineworks/google-ads-transparency?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Similarweb Scraper](https://apify.com/themineworks/similarweb-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google News Scraper](https://apify.com/themineworks/google-news?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**LinkedIn**

- [LinkedIn Company Scraper](https://apify.com/themineworks/linkedin-company-details?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Post Scraper](https://apify.com/themineworks/linkedin-post-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Employees Scraper](https://apify.com/themineworks/linkedin-employees?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Profile Scraper](https://apify.com/themineworks/linkedin-profile-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Real estate**

- [Zillow Rentals Scraper](https://apify.com/themineworks/zillow-rental-listings?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Zillow Sold Comps Scraper](https://apify.com/themineworks/zillow-recently-sold?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [India Real Estate MCP](https://apify.com/themineworks/india-real-estate-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Housing.com Scraper](https://apify.com/themineworks/housing-com-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Science, health and government data**

- [Academic Research MCP](https://apify.com/themineworks/academic-research-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [CourtListener Scraper](https://apify.com/themineworks/courtlistener-court-records?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Socrata Open Data Scraper](https://apify.com/themineworks/socrata-open-data?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [OpenAlex Scraper](https://apify.com/themineworks/openalex-scholarly-works?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Jobs and hiring**

- [Foundit Monster India Jobs](https://apify.com/themineworks/foundit-jobs-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Hirist Jobs Scraper](https://apify.com/themineworks/hirist-jobs-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [India Jobs MCP](https://apify.com/themineworks/india-jobs-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Naukri Jobs Scraper](https://apify.com/themineworks/naukri-jobs?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Company and business data**

- [Company Domain Finder](https://apify.com/themineworks/company-domain-finder?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GST Taxpayer Lookup](https://apify.com/themineworks/gst-taxpayer-lookup?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Company KYB Resolver](https://apify.com/themineworks/company-identity-resolver?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [SEC EDGAR Filings Scraper](https://apify.com/themineworks/sec-edgar-filings?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**E-commerce and marketplaces**

- [Ozon.ru Scraper](https://apify.com/themineworks/ozon-product-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [⭐ Amazon Reviews Scraper](https://apify.com/themineworks/amazon-reviews?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Amazon Product Scraper](https://apify.com/themineworks/amazon-products?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Etsy Listings Scraper](https://apify.com/themineworks/etsy-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Food and local services**

- [NoBroker Scraper](https://apify.com/themineworks/nobroker-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Swiggy Restaurant Scraper](https://apify.com/themineworks/swiggy-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Zomato Scraper](https://apify.com/themineworks/zomato-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Developer and AI tools**

- [Website to Markdown Crawler](https://apify.com/themineworks/rag-crawler?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Skill Finder](https://apify.com/themineworks/github-skill-discovery?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Repo Scraper](https://apify.com/themineworks/github-repo-intelligence?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Trending Scraper](https://apify.com/themineworks/github-trending-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**More tools**

- [G2 Reviews Scraper](https://apify.com/themineworks/g2-reviews-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Naver Blog Scraper](https://apify.com/themineworks/naver-blog-posts-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [WeChat Article Scraper 微信公众号文章](https://apify.com/themineworks/wechat-article-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Taobao Products Scraper 淘宝 天猫](https://apify.com/themineworks/taobao-products-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

# Actor input Schema

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

Words to search on SoundCloud, one per line, as you would type them in the SoundCloud search box. Example: lofi hip hop, techno mix, afrobeats. Each keyword is one search of the type chosen below.

## `searchType` (type: `string`):

What the keywords search: tracks, artists (users), playlists or albums.

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

Links copied from SoundCloud: a track (https://soundcloud.com/forss/flickermood), a playlist or album (https://soundcloud.com/forss/sets/soulhack), an artist (https://soundcloud.com/deadmau5), an artist's /tracks, /popular-tracks, /sets or /albums page, a search link (https://soundcloud.com/search/people?q=house) or an on.soundcloud.com short link.

## `maxItems` (type: `integer`):

The most rows to return for each keyword or link, 1 to 5,000. For an artist link the profile row is extra, so 50 gives the profile plus 50 tracks. SoundCloud ends a search at 300 results; track searches that ask for more are widened over duration and upload date bands to reach your number.

## `includeArtistTracks` (type: `boolean`):

On: an artist link returns the profile row and then the artist's tracks, newest first, up to Max items. Off: the profile row only.

## `includePlaylistTracks` (type: `boolean`):

On: a playlist or album link returns the playlist row and then one row per track in it, in playlist order, up to Max items. Off: the playlist row only, with its track ids.

## `includeArtistLinks` (type: `boolean`):

On: each artist row gets the website, Instagram, YouTube and other links shown on the profile, in links. One extra request per artist, same price.

## `trendingChart` (type: `boolean`):

On: also return SoundCloud's trending top 100 tracks, with chart_rank and chart_score.

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

Track searches only. Keep tracks with this genre or tag, for example techno, house, Hip-hop & Rap.

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

Track searches only. Keep tracks uploaded in the last hour, day, week, month or year.

## `duration` (type: `string`):

Track searches only. short is under 2 minutes, medium 2 to 10, long 10 to 30, epic over 30 (mixes and sets).

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

Track searches only. Keep tracks whose license allows sharing, commercial use, or commercial use with changes.

## Actor input object example

```json
{
  "searchQueries": [
    "lofi hip hop"
  ],
  "searchType": "tracks",
  "maxItems": 30,
  "includeArtistTracks": true,
  "includePlaylistTracks": false,
  "includeArtistLinks": false,
  "trendingChart": false
}
```

# Actor output Schema

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

No description

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

No description

# 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 = {
    "searchQueries": [
        "lofi hip hop"
    ],
    "maxItems": 30
};

// Run the Actor and wait for it to finish
const run = await client.actor("themineworks/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 = {
    "searchQueries": ["lofi hip hop"],
    "maxItems": 30,
}

# Run the Actor and wait for it to finish
run = client.actor("themineworks/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 '{
  "searchQueries": [
    "lofi hip hop"
  ],
  "maxItems": 30
}' |
apify call themineworks/soundcloud-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,themineworks/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/KQy2u8RuJEOE467kX/builds/ecXmNC7uAtbQaFeIa/openapi.json
