# 🚀 SoundCloud Scraper · 5,000 Free Results/Month (`omkar-cloud/soundcloud-scraper`) Actor

SoundCloud Scraper gets you SoundCloud data ⚡ fast, 🎯 100% accurate and 🔍 ridiculously detailed — tracks with plays, likes & ISRC, artists, playlists & Top 50 charts. 💰 $1 per 1,000 results, no start fee. Scrape your first 5,000 results free every month 🚀

- **URL**: https://apify.com/omkar-cloud/soundcloud-scraper.md
- **Developed by:** [Omkar Cloud](https://apify.com/omkar-cloud) (community)
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.00 / 1,000 result 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/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

SoundCloud Scraper by Omkar Cloud gets you 🎯 accurate, 🔍 detailed SoundCloud data.

Every run reads SoundCloud live — so you get today's play, like, repost and comment counts, full track records with ISRCs and labels, artist profiles with their social links, whole playlists and albums, and SoundCloud's official Top 50 and trending charts, and can successfully complete your project.

**$1 per 1,000 results.** And with Apify's free plan you get $5 of credit every month, so your first **~5,000 results each month are free**.

This is an excellent Actor made by Omkar Cloud, which is Rated Excellent — [4.7 based on 30 reviews on Trustpilot](https://www.trustpilot.com/review/omkar.cloud).

👉 [**Try SoundCloud Scraper free**](https://apify.com/omkar-cloud/soundcloud-scraper) — your first ~5,000 results are Free.

### What can I get

- 🔍 **Search SoundCloud** — tracks, artists, playlists or albums by keyword, filtered by genre or tag, duration, upload date, license or city; up to 300 results per query
- 🎵 **Full track records** — plays, likes, reposts, comments and downloads, genre, tags, duration, release date, ISRC, UPC, label and rights lines, artwork, waveform and the artist
- 🎤 **Artists, playlists & albums** — followers, uploads, likes, city, verified and Pro badges, banner; playlists and albums with track count, duration, likes and the creator
- 🔗 **From any link** — paste soundcloud.com track, artist, playlist, album or station links (or on.soundcloud.com share links) and get the full record back
- 📈 **Official charts** — the weekly Top 50 for the US and the UK (overall, New & Hot and per genre), the daily trending chart with trending scores, and 20 trending-by-genre playlists
- ➕ **Full details add-on** — every artist's website and social links (Instagram, TikTok, YouTube, Spotify…), every playlist's and album's whole tracklist

### Why SoundCloud Scraper

Most other SoundCloud scrapers fail you in one of four ways:

- 🧩 **Low-detail data** — a title and a play count, never the ISRC, the label or the rights
- 🪓 **One thing only** — a search *or* a link *or* a chart, so you chain three actors for one job
- 💸 **Pay more to get the same data** — start fees, tiers and paid "extra data" events
- 🪦 **Works today, breaks next month** — nobody maintains it

SoundCloud Scraper does search, links and charts in one run, is priced honestly, and actively maintained.

### Example: A Full SoundCloud Track Record

```json
{
  "source": "https://soundcloud.com/billieeilish/ocean-eyes",
  "record_type": "track",
  "id": 233719633,
  "title": "Ocean Eyes",
  "link": "https://soundcloud.com/billieeilish/ocean-eyes",
  "genre": "Indie",
  "tags": ["Pop", "Dark", "Billie", "Eilish", "Ocean Eyes"],
  "license": "all-rights-reserved",
  "duration_ms": 200456,
  "duration": "3:20",
  "stats": {
    "plays": 75074329,
    "likes": 1334600,
    "reposts": 29311,
    "comments": 28409,
    "downloads": 39
  },
  "user": {
    "id": 87105617,
    "username": "Billie Eilish",
    "link": "https://soundcloud.com/billieeilish",
    "followers_count": 3943858,
    "is_verified": true
  },
  "artwork": {
    "link": "https://i1.sndcdn.com/artworks-000194211850-6zfpyg-t500x500.jpg",
    "original_link": "https://i1.sndcdn.com/artworks-000194211850-6zfpyg-original.jpg"
  },
  "publisher": { "artist": "Billie Eilish", "isrc": "US23A1500056" },
  "purchase": { "title": "STREAM", "link": "https://open.spotify.com/album/2msN7XBgV3JCjQ7Tq3t7i9" },
  "is_streamable": true,
  "waveform_link": "https://wave.sndcdn.com/gE8zJfoXbliZ_m.json",
  "created_at": "2015-11-19T03:18:57Z"
}
```

*Trimmed for readability — the real row carries all 18 tags, the full publisher block and every flag.*

A search row carries `search_query` and `search_type` in front of the result fields; a chart row carries `chart_type` (`top_50`, `trending` or `trending_by_genre`), the chart it came from and the track's `rank`.

### Get Started with 5,000 Free Results

1. [Hit **Try for Free Button**](https://apify.com/omkar-cloud/soundcloud-scraper) — the input is pre-filled with a "billie eilish" track search.
2. Enjoy your data 😎.

### Pricing

High value, Low price.

| What | Price | What you get |
|---|---|---|
| **Results** | **$1 per 1,000** | A search result, a chart entry or a record from a link — tracks with plays, likes, reposts, comments, ISRC, label, artwork and the artist; artists with followers, uploads, city and badges; playlists and albums with track count, duration and creator |
| **Full details** (optional add-on) | **+$1 per 1,000** | On artist, playlist and album rows only, when **Include Details** is on: the artist's website and social links, or the playlist's / album's whole tracklist with every track in full |

No start fee, one flat price on every plan — you pay only for the rows you get. Control your spend with **Max Results per Query** and **Chart Size**: 1,000 results ≈ $1. One query at the default 100 results costs about $0.10; a link costs $0.001; a Top 50 chart costs $0.05.

💡 Apify's free plan includes $5 of credit every month — about **5,000 free results, every month**.

👉 [**Scrape your first 5,000 results free**](https://apify.com/omkar-cloud/soundcloud-scraper)

### Run It from Code

Grab your API token from [Integrations Settings here](https://console.apify.com/settings/integrations) and replace `<YOUR_API_TOKEN>` below.

**Python** (`pip install apify-client`)

```python
from apify_client import ApifyClient

client = ApifyClient("<YOUR_API_TOKEN>")
run = client.actor("omkar-cloud/soundcloud-scraper").call(run_input={
    "queries": ["lofi hip hop"],
    "searchType": "tracks",
    "uploadedWithin": "month",
    "maxResults": 50,
    "urls": ["https://soundcloud.com/billieeilish/ocean-eyes"],
})
for row in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(row["title"], row["stats"]["plays"], row["link"])
```

**Node.js** (`npm install apify-client`)

```javascript
import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: '<YOUR_API_TOKEN>' });
const run = await client.actor('omkar-cloud/soundcloud-scraper').call({
    top50Charts: ['all-music-genres', 'new-hot'],
    top50Country: 'US',
    trendingChart: true,
    chartSize: 50,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);
```

### FAQ

#### What can I search for?

Tracks, artists (users), playlists or albums — pick the **Search Type**, list your **Queries** one per line, and every query is searched separately, up to **Max Results per Query**. Narrow track searches by **Genre or Tag**, **Duration**, **Uploaded Within** and **License**; narrow artist searches by **City**. SoundCloud serves the first 300 results of any search, so that is the ceiling per query — use filters to reach deeper.

#### How do I get the full record of a track, artist or playlist?

Paste it under **URLs** — a soundcloud.com link (`https://soundcloud.com/billieeilish/ocean-eyes`), an on.soundcloud.com share link, a permalink path (`billieeilish/ocean-eyes`) or an id as `track:<id>`, `user:<id>` or `playlist:<id>`. A bare number is not accepted because a track, an artist and a playlist can share the same id. Rows carry `source` and `record_type`.

#### What does Include Details add?

On artist rows: every website and social link on the profile (Instagram, TikTok, YouTube, Spotify, Twitter, Facebook, merch store…). On playlist and album rows: the whole tracklist, every track in full with plays, likes and ISRC. It is billed as the `details` add-on on those rows only — track rows are already complete and never charged for it.

#### How do the charts work?

List the **Top 50 Charts** you want (`all-music-genres`, `new-hot`, `hip-hop`, `pop`…) and pick the **Top 50 Country** (US or UK). Tick **Trending Chart** for SoundCloud's daily trending chart with trending scores, and list genres under **Trending by Genre** (`hip-hop`, `trap`, `pop`, `electronic`, `r-n-b`…). **Chart Size** sets the entries per chart (1–100). Chart rows keep every entry, so the same song in two charts is two rows.

#### Can I combine searches, links and charts in one run?

Yes — fill in any of the sections and everything runs in one job. A record that comes back twice (the same track from two searches, or from a link and then a search) is pushed and billed once.

#### What does it cost?

$0.001 per result — $1 per 1,000, flat on every plan, with no start fee. The optional full-details add-on is another $0.001 per artist, playlist or album row it enriches. Apify's free plan gives you $5 of credit every month, which is 5,000 results free every month.

#### Is it legal to scrape SoundCloud?

The Actor collects publicly available track, profile, playlist and chart data — the same data soundcloud.com shows any visitor. Please review SoundCloud's terms of use and make sure your use complies with the law of your jurisdiction.

#### Can I get followers, likers or comments?

Not with this Actor — use [SoundCloud Followers Scraper](https://apify.com/omkar-cloud/soundcloud-followers-scraper) for followers, followings, likers and reposters, and [SoundCloud Comments Scraper](https://apify.com/omkar-cloud/soundcloud-comments-scraper) for timed comments.

### 💬 Have Questions? We Have Answers.

You're a business owner — we know how hard completing a project can be. So we offer full support: just message us and we'll reply ✅ with a solution within 1 working day.

[![Message Us on WhatsApp](https://raw.githubusercontent.com/omkarcloud/assets/master/images/whatsapp-us.png)](https://api.whatsapp.com/send?phone=918178804274\&text=I%20need%20help%20with%20using%20the%20SoundCloud%20Scraper%20Actor.)

[![Ask Us on Email](https://raw.githubusercontent.com/omkarcloud/assets/master/images/ask-on-email.png)](mailto:happy.to.help@omkar.cloud?subject=Help%20with%20SoundCloud%20Scraper%20Actor\&body=I%20need%20help%20with%20using%20the%20SoundCloud%20Scraper%20Actor.)

You are important to us — just message us and we will solve your problem ✅ within 1 working day. 🩷 Pinky Promise 🤙!

### Popular Actors by Omkar Cloud

- [**Deezer Scraper**](https://apify.com/omkar-cloud/deezer-scraper) — Deezer tracks with ISRC, albums, artists, playlists & charts, $1 per 1,000 results
- [**Booking Scraper**](https://apify.com/omkar-cloud/booking-scraper) — Booking.com hotels: prices, ratings, rooms & amenities
- [**Rightmove Scraper**](https://apify.com/omkar-cloud/rightmove-scraper) — UK homes for sale, to rent & new homes with agent phones, $1 per 1,000 listings
- [**Zoopla Scraper**](https://apify.com/omkar-cloud/zoopla-scraper) — Zoopla homes for sale, to rent & new homes with agent phones, $1 per 1,000 listings
- [**IMDb Scraper**](https://apify.com/omkar-cloud/imdb-scraper) — IMDb titles, charts, cast, ratings & box office
- [**G2 Product Scraper**](https://apify.com/omkar-cloud/g2-product-scraper) — G2 product details, ratings & AI-found contacts
- [**Website Email Contact Scraper**](https://apify.com/omkar-cloud/website-email-contact-scraper) — emails, phones & socials from any website
- [**Etsy Scraper**](https://apify.com/omkar-cloud/etsy-scraper) — Etsy products: prices, discounts, shops & variations

👉 [**Scrape your first 5,000 results free now**](https://apify.com/omkar-cloud/soundcloud-scraper)

# Actor input Schema

## `queries` (type: `array`):

Search phrases, one per line — an artist (`billie eilish`), a song, a genre (`lofi hip hop`) or a playlist theme (`workout`).

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

What the queries search for. Tracks come with plays, likes, reposts, comments, genre, tags, ISRC, label and the artist; users (artists) with followers, track count, city and badges; playlists and albums with track count, duration, likes and the creator.

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

Only results with this genre or tag (`lofi`, `hip-hop`, `house`, `classical`…). Tracks, playlists and albums.

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

Track length: short (under 2 min), medium (2–10 min), long (10–30 min) or epic (over 30 min).

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

Only tracks uploaded in the last hour, day, week, month or year.

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

Only tracks licensed to share, to use commercially or to modify commercially.

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

Only users in this city (`los angeles`, `new york`, `london`). Users search only.

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

Maximum number of results per query (1–300; SoundCloud serves the first 300 results of any search). Use this to control your cost: 1,000 results ≈ $1.

## `urls` (type: `array`):

One per line: a soundcloud.com track, artist, playlist, album or station link (`https://soundcloud.com/billieeilish/ocean-eyes`, `https://soundcloud.com/billieeilish`), an on.soundcloud.com share link, a permalink path (`billieeilish/ocean-eyes`), or an id written as `track:233719633`, `user:87105617` or `playlist:345241809`. A bare number is not accepted — a track, an artist and a playlist can share the same id.

## `includeDetails` (type: `boolean`):

Add the full record to every artist, playlist and album row: an artist's website and social links (Instagram, TikTok, YouTube, Spotify…), a playlist's or album's whole tracklist with every track in full. Billed as the `details` add-on on those rows only; track rows are already complete and never charged for it.

## `top50Charts` (type: `array`):

Which Top 50 charts to scrape, one per line: `all-music-genres`, `new-hot`, `artist-pro`, `hip-hop`, `pop`, `electronic`, `rock`, `folk`, `latin`, `country` (US) — the UK adds `dance`, `r-b` and `indie`.

## `top50Country` (type: `string`):

Country of the Top 50 charts above.

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

Scrape SoundCloud's trending chart (all music, refreshed daily), with SoundCloud's trending score on every track.

## `trendingGenres` (type: `array`):

Genres whose trending playlist to scrape, one per line: `all-genres`, `hip-hop`, `trap`, `pop`, `electronic`, `r-n-b`, `house`, `indie`, `dubstep`, `rock`, `latin`, `afrobeat`, `ambient`, `metal`, `reggae`…

## `chartSize` (type: `integer`):

Entries per chart (1–100).

## Actor input object example

```json
{
  "queries": [
    "billie eilish"
  ],
  "searchType": "tracks",
  "maxResults": 100,
  "urls": [
    "https://soundcloud.com/billieeilish/ocean-eyes",
    "https://soundcloud.com/billieeilish",
    "https://soundcloud.com/billieeilish/sets/dont-smile-at-me"
  ],
  "includeDetails": false,
  "top50Charts": [
    "all-music-genres",
    "new-hot",
    "hip-hop"
  ],
  "top50Country": "US",
  "trendingChart": false,
  "trendingGenres": [
    "hip-hop",
    "pop"
  ],
  "chartSize": 50
}
```

# Actor output Schema

## `results` (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 = {
    "queries": [
        "billie eilish"
    ],
    "maxResults": 100
};

// Run the Actor and wait for it to finish
const run = await client.actor("omkar-cloud/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 = {
    "queries": ["billie eilish"],
    "maxResults": 100,
}

# Run the Actor and wait for it to finish
run = client.actor("omkar-cloud/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 '{
  "queries": [
    "billie eilish"
  ],
  "maxResults": 100
}' |
apify call omkar-cloud/soundcloud-scraper --silent --output-dataset

```

## MCP server setup

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