SoundCloud Scraper

Extract tracks, playlists, and artist profiles from SoundCloud — including play counts, likes, reposts, genre, tags, waveforms, artwork, and stream URLs. No API key or account required.

What This Actor Does

• Charts — browse top or trending tracks by genre (all music, hip-hop, electronic, pop, and 25+ more genres)
• Search — search for tracks, users/artists, playlists, or albums by keyword
• Artist Tracks — fetch all tracks from a specific artist profile
• By URL — resolve any SoundCloud track, playlist, or user URL to structured data

---

Output Fields

Each record contains the following fields (omit-empty — fields absent when not available):

Field	Type	Description
title	string	Track, playlist, or artist name
url	string	Direct SoundCloud URL
trackId	string	SoundCloud internal ID
artist	string	Artist/uploader username
artistUrl	string	URL to the artist's SoundCloud profile
duration	string	Duration in MM:SS or HH:MM:SS format
playCount	integer	Total play count
likeCount	integer	Number of likes/favorites
repostCount	integer	Number of reposts
commentCount	integer	Number of comments
genre	string	Genre label
tags	array	List of tags attached to the track
uploadDate	string	ISO-8601 upload date
streamUrl	string	Direct stream/transcoding URL
artworkUrl	string	High-resolution artwork image URL (500×500)
waveformUrl	string	Waveform image URL
description	string	Track or artist description
recordType	string	Record type: track, user, or playlist
scrapedAt	string	ISO-8601 scrape timestamp

Example Output

{
  "title": "Chill Lofi Beat",
  "url": "https://soundcloud.com/artist/chill-lofi-beat",
  "trackId": "12345678",
  "artist": "lofi_producer",
  "artistUrl": "https://soundcloud.com/lofi_producer",
  "duration": "3:45",
  "playCount": 125000,
  "likeCount": 4200,
  "repostCount": 890,
  "commentCount": 145,
  "genre": "Hip-hop & Rap",
  "tags": ["lofi", "chill", "beats", "study"],
  "uploadDate": "2023-08-15T14:32:00+00:00",
  "streamUrl": "https://api-v2.soundcloud.com/media/...",
  "artworkUrl": "https://i1.sndcdn.com/artworks-...-t500x500.jpg",
  "waveformUrl": "https://wave.sndcdn.com/..._m.png",
  "description": "Chill lofi hip-hop beats for studying and relaxing.",
  "recordType": "track",
  "scrapedAt": "2024-12-15T10:30:00+00:00"
}

---

Input Configuration

Mode

Value	Description
charts	Top/trending tracks by genre (default)
search	Search tracks, users, playlists, or albums
artistTracks	All tracks from a specific artist profile
byUrl	Fetch a specific track/playlist/user URL

Input Fields

Field	Type	Default	Description
mode	select	charts	Scraping mode
chartKind	select	top	top (most-played) or trending
genre	select	all-music	Genre filter for charts and search
searchQuery	string	chill lofi	Search keyword (mode=search)
searchKind	select	tracks	What to search: tracks, users, playlists, albums
artistUrl	string	—	Artist profile URL (mode=artistTracks)
startUrls	array	[]	URLs to scrape (mode=byUrl)
maxItems	integer	20	Maximum records to return (1–500)

Available Genres

All Music, Alternative Rock, Ambient, Classical, Country, Dance & EDM, Dancehall, Deep House, Disco, Drum & Bass, Dubstep, Electronic, Folk & Singer-Songwriter, Hip-hop & Rap, House, Indie, Jazz & Blues, Latin, Metal, Piano, Pop, R&B & Soul, Reggae, Reggaeton, Rock, Soundtrack, Techno, Trance, Trap, Trip Hop, World

---

Use Cases

• Music discovery — find trending tracks by genre without a SoundCloud account
• Artist research — extract a complete discography from any public SoundCloud profile
• Playlist curation — gather track metadata for playlist building tools
• Music analytics — monitor play counts, likes, and reposts over time
• Content monitoring — track new uploads from specific artists
• Podcast discovery — SoundCloud hosts many podcasts; use search to find episodes

---

FAQ

Does this require a SoundCloud account?
No. All data is extracted from public SoundCloud pages and the public API. No login or API key is required.

How does the actor get the SoundCloud client_id?
SoundCloud embeds a rotating client_id in their public JavaScript bundles. The actor automatically extracts this from the homepage before making API calls.

Can I download the audio files?
The streamUrl field provides the SoundCloud stream URL. Whether you can download from it depends on the track's streaming permissions set by the artist.

What's the difference between top and trending charts?
top returns the most-played tracks of all time in a genre. trending returns what's gaining traction right now.

Why might playCount be missing on some tracks?
SoundCloud only returns play counts for tracks with a sufficient play history. New or private tracks may not have this data.

How many tracks can I fetch per run?
Up to 500 records per run using the maxItems parameter. For larger datasets, run multiple times with different genres or search queries.

Can I scrape private tracks?
No. The actor only accesses public tracks available without authentication.