Reef AI: ask for any data. Try it
Looking for the overview — what this API returns, what it costs, and a call you can run without a key? See the SoundCloud API page →
Media, Film & Knowledge

SoundCloud API & Scraper

This API reads SoundCloud as JSON, logged out, the way a visitor of soundcloud.com sees it.

41 actionsLive JSON1,000 free credits$0.67–$1.50 / 1,000 creditsMCP-ready
Get a free keyOpen in playground

🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.

`track` returns one track in one call: play, like, repost, comment and download counts, the label and publisher block where the uploader filled it in (ISRC, UPC/EAN, album and release title, publisher, writer/composer, ℗ and © lines, explicit flag), genre, tags, license, duration, upload, release and display dates, artwork, the buy link and the uploader with follower count. `tracks_batch` returns up to 50 tracks in one call. `user` returns a profile with follower, following, track, playlist, like and comment counts, verified and Pro badges, name, city, country, bio, avatar, banner and every website and social link on the profile. Lists page with a cursor: a track's timed comments, likers and reposters; a user's tracks, top tracks, playlists, albums, likes, reposts, activity feed, followers, followings and comments; a playlist's tracks, likers and reposters. Search covers everything, tracks (filters: genre or tag, length, added date, Creative Commons license), users (filter: city) and playlists or albums (filter: genre), and returns SoundCloud's genre and city counts. Charts are the official US and UK Top 50 (overall and by genre), the trending top 100 and trending by genre. Audio files are not returned.

Reference

What a SoundCloud field actually contains

Fields that read differently from how they look. Every row was measured against live SoundCloud on 2026-11-16.

FieldWhat it holds
playback_count, likes_count, comment_count, download_countExact all-time counts as integers. They matched the numbers soundcloud.com prints in the same track page's own metadata on 9 of 9 tracks checked, read within 1 second of each other (Flickermood: 974,177 plays, 2,621 likes, 400 comments, 23,537 downloads). The page shows them rounded (974K).
followers_count, track_count (user)Exact integers. Equal to the follower and track numbers on the profile page on 9 of 9 profiles (skrillex: 6,716,839 followers, 299 tracks).
publisher.isrc, publisher.upc_or_eanThe label metadata the uploader entered. Filled on 30 of 100 search results across 10 genres: 10 of 10 for a label release search (drake), 0 of 10 for lofi and classical piano uploads. Null means the uploader did not enter it.
publisher.p_line, publisher.p_line_for_displayBoth are returned as SoundCloud sends them; they are not always the same: p_line was filled on 20 of 100 tracks, p_line_for_display on 28 of 100.
created_at, display_date, release_date (track)created_at is when the file was uploaded. display_date is the date the track page shows (later than created_at when a track was scheduled or made public later). release_date is the release date the uploader entered, filled on 27 of 120 tracks.
timestamp_ms, position (comment)Where in the track the comment was left, in milliseconds and as m:ss (87833 → 1:27).
track_ids (playlist)Every track id of a playlist in order. A 416-track playlist returned 416 ids; playlist_tracks pages through them in full, 50 per page.
city, country_code (user)As the user entered them: city on 23 of 41 profiles, country on 18 of 41. created_at and reposts_count are null on every profile: SoundCloud does not publish them.
total_estimate (search)SoundCloud's own estimate of the result count. It moves between identical calls ("house": 5.5 to 6.7 million within one minute); use it as an order of magnitude.
unavailable_idsTracks in a playlist, chart or station that SoundCloud no longer serves (deleted or made private). They are listed by id instead of being returned as empty rows.

Data is what SoundCloud shows a logged-out visitor. Counts are worldwide. Audio files and stream links are not returned; audio_formats lists the formats a track is encoded in.

Live example

Real request and response JSON

Captured from the indexed primary action, search, on .

Captured request
{
  "method": "POST",
  "url": "https://api.reefapi.com/soundcloud/v1/search",
  "headers": {
    "x-api-key": "$REEF_KEY",
    "content-type": "application/json"
  },
  "body": {
    "query": "house"
  }
}
Captured response
{
  "ok": true,
  "meta": {
    "api": "soundcloud",
    "endpoint": "search",
    "mode": "live",
    "latency_ms": 1651.7,
    "record_count": 20,
    "bytes": 78497,
    "cache_hit": false,
    "upstream_requests": 1,
    "extra_rows_trimmed": 2,
    "charged_credits": 1,
    "version": "0.1.0",
    "request_id": "c13c137b4ccf435e",
    "queue_ms": 2,
    "fetched_at": "2026-11-16T21:05:27.124Z"
  },
  "data": {
    "query": "house",
    "results": [
      {
        "kind": "user",
        "id": 5614319,
        "urn": "soundcloud:users:5614319",
        "username": "Azureon: Surge",
        "permalink": "housemusic",
        "url": "https://soundcloud.com/housemusic",
        "full_name": null,
        "first_name": null,
        "last_name": null,
        "city": "World",
        "country_code": null,
        "verified": true,
        "followers_count": 523794,
        "avatar_url": "https://i1.sndcdn.com/avatars-3OQJ6hZTkFMSNJAu-xAghAw-large.jpg",
        "avatar_url_500": "https://i1.sndcdn.com/avatars-3OQJ6hZTkFMSNJAu-xAghAw-t500x500.jpg",
        "badges": {
          "pro": false,
          "creator_mid_tier": false,
          "pro_unlimited": true,
          "verified": true
        },
        "last_modified": "2024-11-06T17:19:52Z",
        "station_urn": "soundcloud:system-playlists:artist-stations:5614319",
        "description": "Submit Music: https://aia.ag/Submit-Music\n\nSpotify Playlists: https://aia.ag/Spotify\n\nApple Music Playlists: https://aia.ag/Apple-Music\n\n> Licensing Inquiries: [redacted-email]\n\nthe Indie Select family:\n\nAzureon Select:\n@Azureon\n@HouseMusic\n@DeepSounds\n@IvoryOasis\n@FirstEdition\n\nHegemon Select:\n@Hegemon\n@Wonderlust\n@Chill\n@XXX\n@Your_Secret\n@Lavish\n\nPantheon Select:\n@WeArePantheon\n@Dubstep\n@TrapMusic\n@Type91",
        "followings_count": 16,
        "track_count": 470,
        "playlist_count": 34,
        "likes_count": 20,
        "playlist_likes_count": 0,
        "reposts_count": null,
        "comments_count": 0,
        "groups_count": 0,
        "created_at": null,
        "date_of_birth": null,
        "creator_subscription": "creator-pro-unlimited",
        "banner_url": "https://i1.sndcdn.com/visuals-000005614319-DUpbEt-original.jpg",
        "station_url": "https://soundcloud.com/discover/sets/artist-stations:5614319"
      },
      {
        "id": 935144824,
        "urn": "soundcloud:tracks:935144824",
        "kind": "track",
        "title": "Friendly Fire - I Love Techno",
        "url": "https://soundcloud.com/housemusic/friendly-fire-i-love-techno",
        "permalink": "friendly-fire-i-love-techno",
        "secret_token": "[redacted-secret]",
        "user": {
          "id": 5614319,
          "urn": "soundcloud:users:5614319",
          "username": "Azureon: Surge",
          "permalink": "housemusic",
          "url": "https://soundcloud.com/housemusic",
          "full_name": null,
          "first_name": null,
          "last_name": null,
          "city": "World",
          "country_code": null,
          "verified": true,
          "followers_count": 523794,
          "avatar_url": "https://i1.sndcdn.com/avatars-3OQJ6hZTkFMSNJAu-xAghAw-large.jpg",
          "avatar_url_500": "https://i1.sndcdn.com/avatars-3OQJ6hZTkFMSNJAu-xAghAw-t500x500.jpg",
          "badges": {
            "pro": "[trimmed-depth]",
            "creator_mid_tier": "[trimmed-depth]",
            "pro_unlimited": "[trimmed-depth]",
            "verified": "[trimmed-depth]"
          },
          "last_modified": "2024-11-06T17:19:52Z",
          "station_urn": "soundcloud:system-playlists:artist-stations:5614319"
        },
        "user_id": 5614319,
        "artist": "Friendly Fire",
        "description": "💥 Stream/Download: https://azureon.ffm.to/bob7jmd\n→  Submit Music: http://aia.ag/Music-Submissions\n→  Business/Licensing Inquiry: [redacted-email]\n🎧 Spotify Playlists: http://spotify.aia.ag/AIA_Spotify\n\n-------------------------------------------------------------------------

\n➥ Follow: Friendly Fire\nSoundCloud: https://soundcloud.com/friendlyfireoff\nFacebook:
 https://facebook.com/frndlyfiremusic\nTwitter: https://twitter.com/Frndlyfiremusic\nInstagram: https://instagram.com/friendlyfireoff",
        "caption": null,
        "genre": "Dance & EDM",
        "tags": [
          "Electro",
          "Electro House",
          "Heavy"
        ],
        "tag_list": "Electro \"Electro House\" Heavy Filthy Electronic Dance Music Bass \"Free Download\" GetMorePlays",
        "label_name": null,
        "license": "all-rights-reserved",
        "duration_ms": 217202,
        "full_duration_ms": 217182,
        "duration": "3:37",
        "created_at": "2020-11-24T14:04:16Z",
        "release_date": null,
        "display_date": "2020-12-28T15:00:04Z",
        "last_modified": "2021-06-07T12:22:32Z",
        "playback_count": 234402,
        "likes_count": 3928,
        "reposts_count": 316,
        "comment_count": 87,
        "download_count": 0,
        "artwork_url": "https://i1.sndcdn.com/artworks-GXgyyXsQtcGx8ga2-f8uC0g-large.jpg",
        "artwork_url_500": "https://i1.sndcdn.com/artworks-GXgyyXsQtcGx8ga2-f8uC0g-t500x500.jpg",
        "banner_url": null,
        "waveform_url": "https://wave.sndcdn.com/luJ4mjDayxHI_m.json",
        "publisher": {
          "artist": "Friendly Fire",
          "album_title": null,
          "contains_music": true,
          "publisher": "Indie Music Publishing LLC 100%",
          "isrc": "QMWZB2010577",
          "writer_composer": "Benjamin Avery Hiner",
          "release_title": "I Love Techno"
        },
        "purchase_title": "Stream or Download",
        "purchase_url": "https://azureon.ffm.to/bob7jmd",
        "commentable": true,
        "downloadable": false,
        "has_downloads_left": false,
        "streamable": true,
        "public": true,
        "sharing": "public",
        "state": "finished",
        "embeddable_by": "all",
        "policy": "MONETIZE",
        "monetization_model": "AD_SUPPORTED",
        "audio_formats": [
          {
            "protocol": "[trimmed-depth]",
            "mime_type": "[trimmed-depth]",
            "preset": "[trimmed-depth]",
            "quality": "[trimmed-depth]",
            "duration_ms": "[trimmed-depth]",
            "snipped": "[trimmed-depth]",
            "is_legacy_transcoding": "[trimmed-depth]"
          },
          {
            "protocol": "[trimmed-depth]",
            "mime_type": "[trimmed-depth]",
            "preset": "[trimmed-depth]",
            "quality": "[trimmed-depth]",
            "duration_ms": "[trimmed-depth]",
            "snipped": "[trimmed-depth]",
            "is_legacy_transcoding": "[trimmed-depth]"
          },
          {
            "protocol": "[trimmed-depth]",
            "mime_type": "[trimmed-depth]",
            "preset": "[trimmed-depth]",
            "quality": "[trimmed-depth]",
            "duration_ms": "[trimmed-depth]",
            "snipped": "[trimmed-depth]",
            "is_legacy_transcoding": "[trimmed-depth]"
          }
        ],
        "station_urn": "soundcloud:system-playlists:track-stations:935144824",
        "station_url": "https://soundcloud.com/discover/sets/track-stations:935144824"
      },
      {
        "kind": "user",
        "id": 156592242,
        "urn": "soundcloud:users:156592242",
        "username": "Maccabi House",
        "permalink": "maccabihouse",
        "url": "https://soundcloud.com/maccabihouse",
        "full_name": null,
        "first_name": null,
        "last_name": null,
        "city": "Tel-Aviv",
        "country_code": "IL",
        "verified": false,
        "followers_count": 71612,
        "avatar_url": "https://i1.sndcdn.com/avatars-T6WTyDJiEQ61YRQE-WsTSMA-large.jpg",
        "avatar_url_500": "https://i1.sndcdn.com/avatars-T6WTyDJiEQ61YRQE-WsTSMA-t500x500.jpg",
        "badges": {
          "pro": false,
          "creator_mid_tier": false,
          "pro_unlimited": true,
          "verified": false
        },
        "last_modified": "2026-10-28T13:31:10Z",
        "station_urn": "soundcloud:system-playlists:artist-stations:156592242",
        "description": "Demos: https://tstack.app/maccabihouse\n\nElectronic music brand based in Tel-Aviv.\nPushing artists to make music that matters.",
        "followings_count": 2,
        "track_count": 265,
        "playlist_count": 49,
        "likes_count": 157,
        "playlist_likes_count": 8,
        "reposts_count": null,
        "comments_count": 0,
        "groups_count": 0,
        "created_at": null,
        "date_of_birth": null,
        "creator_subscription": "creator-pro-unlimited",
        "banner_url": "https://i1.sndcdn.com/visuals-000156592242-LoeQt9-original.jpg",
        "station_url": "https://soundcloud.com/discover/sets/artist-stations:156592242"
      }
    ],
    "count": 20,
    "total_estimate": 11244273,
    "page": 1,
    "limit": 20,
    "has_more": true
  }
}
Actions

What the SoundCloud API does

ActionDescriptionConcrete use caseKey params
trackEverything SoundCloud publishes about one track: play, like, repost, comment and download counts, label and publisher metadata (ISRC, UPC/EAN, album and release title, publisher, writer/composer, ℗ and © lines, explicit flag), genre, tags, license, duration, upload / release / display dates, artwork, waveform link, buy link, the uploader with follower count, and the audio formats it is transcoded to (no audio).Content platforms call track to get everything SoundCloud publishes about one track.track
tracks_batchUp to 50 tracks in one call (SoundCloud answers all of them in one request), by numeric id or URN. Ids SoundCloud no longer serves come back in `not_found_ids`.Research tools call tracks_batch to get up to 50 tracks in one call (SoundCloud answers all of them in one request), by numeric id or….ids
track_commentsA track's comments, newest first, each with the position in the track it was left at (`timestamp_ms`, `position` m:ss) and the commenter. A page can hold fewer rows than `limit` (SoundCloud leaves hidden comments out); `next_cursor` still continues without gaps.Community analysts call track_comments to get a track's comments, newest first, each with the position in the track it was left at (`timest….track, limit, cursor
track_likersUsers who liked a track, most recent like first.Media monitors call track_likers to get users who liked a track, most recent like first..track, limit, cursor
track_repostersUsers who reposted a track, most recent first.Content platforms call track_reposters to get users who reposted a track, most recent first..track, limit, cursor
track_relatedTracks SoundCloud recommends next to a track ("Related tracks"). SoundCloud serves at most ~50 (measured: limit 100 → 46).Research tools call track_related to get tracks SoundCloud recommends next to a track ("Related tracks").track, limit
track_playlistsPublic playlists and/or albums that contain a track.Community analysts call track_playlists to get public playlists and/or albums that contain a track..track, type, limit, cursor
track_stationThe track's station — SoundCloud's endless mix seeded by the track — with every track in full, one page at a time.Media monitors call track_station to get the track's station.track, page, limit
track_waveformThe waveform SoundCloud's player draws for a track: the sample heights as published (`samples`, integers 0..`height`) and the same values scaled to 0..1 (`samples_normalized`).Content platforms call track_waveform to get the waveform SoundCloud's player draws for a track.track
userA SoundCloud profile: follower, following, track, playlist, like, repost and comment counts, verified and Pro badges, full / first / last name, city, country, bio, avatar and banner, creation date, and every website / social link on the profile.Research tools call user to get a SoundCloud profile.user
user_web_profilesThe websites and social links listed on a profile.Community analysts call user_web_profiles to get the websites and social links listed on a profile..user
user_tracksEvery track a user uploaded, newest first.Media monitors call user_tracks to get every track a user uploaded, newest first..user, limit, cursor
user_top_tracksThe profile's "Popular tracks" (SoundCloud ranks them; at most 50).Content platforms call user_top_tracks to get the profile's "Popular tracks" (SoundCloud ranks them; at most 50)..user, limit
user_playlistsA user's public playlists and/or albums.Research tools call user_playlists to get a user's public playlists and/or albums..user, type, limit, cursor
user_likesTracks and/or playlists a user liked, with the date of each like.Community analysts call user_likes to get tracks and/or playlists a user liked, with the date of each like..user, type, limit, cursor
user_repostsTracks and playlists a user reposted, with the repost date and caption.Media monitors call user_reposts to get tracks and playlists a user reposted, with the repost date and caption..user, limit, cursor
user_activityA profile's feed as shown on soundcloud.com: its uploads and reposts (tracks and playlists), newest first, with type and date.Content platforms call user_activity to get a profile's feed as shown on soundcloud.com.user, limit, cursor
user_followersA user's followers with their own follower counts, city and country.Research tools call user_followers to get a user's followers with their own follower counts, city and country..user, limit, cursor
user_followingsAccounts a user follows.Community analysts call user_followings to get accounts a user follows..user, limit, cursor
user_commentsComments a user left, newest first, each with the track it is on.Media monitors call user_comments to get comments a user left, newest first, each with the track it is on..user, limit, cursor
user_related_artistsSoundCloud's "Fans also like" artists for a profile (SoundCloud serves 10, measured).Content platforms call user_related_artists to get soundCloud's "Fans also like" artists for a profile (SoundCloud serves 10, measured)..user
user_spotlightThe tracks and playlists a profile pinned to its Spotlight.Research tools call user_spotlight to get the tracks and playlists a profile pinned to its Spotlight..user
artist_stationThe artist's station — SoundCloud's endless mix seeded by the profile — with every track in full, one page at a time.Community analysts call artist_station to get the artist's station.user, page, limit
playlistA playlist or album: title, owner, description, genre, tags, label, license, track count, total duration, like and repost counts, dates, artwork, every track id in order, and the first page of tracks in full.Media monitors call playlist to get a playlist or album.playlist, limit
playlist_tracksA playlist's or album's tracks in order, numbered, one page at a time (50 per page at most).Content platforms call playlist_tracks to get a playlist's or album's tracks in order, numbered, one page at a time (50 per page at most)..playlist, page, limit
playlist_likersUsers who liked a playlist or album.Research tools call playlist_likers to get users who liked a playlist or album..playlist, limit, cursor
playlist_repostersUsers who reposted a playlist or album.Community analysts call playlist_reposters to get users who reposted a playlist or album..playlist, limit, cursor
searchSearch everything (tracks, users, playlists and albums mixed, as SoundCloud's "Everything" tab). SoundCloud serves the first 300 results of a query. `total_estimate` is SoundCloud's own estimate and moves between calls.Media monitors call search to search everything (tracks, users, playlists and albums mixed, as SoundCloud's "Everything" tab).query, page, limit
search_tracksSearch tracks with SoundCloud's own filters: genre or tag, length, "Added" date and Creative Commons license. Returns the query's genre counts (`genre_counts`). SoundCloud serves the first 300 results; filters narrow a query below that.Content platforms call search_tracks to search tracks with SoundCloud's own filters.query, genre, duration, added_within, license, ...
search_usersSearch people and artists, optionally in one city. Returns the query's top cities with counts (`place_counts`); pass one back as `place`.Research tools call search_users to search people and artists, optionally in one city.query, place, page, limit
search_playlistsSearch playlists and/or albums, optionally by genre or tag. Returns the query's genre counts.Community analysts call search_playlists to search playlists and/or albums, optionally by genre or tag.query, type, genre, page, limit
autocompleteWhat SoundCloud's search box suggests for the typed text: query completions and matching tags.Media monitors call autocomplete to get what SoundCloud's search box suggests for the typed text.query
charts_trendingSoundCloud's trending chart (all music), ranked, each track with its trending score. SoundCloud serves the top 100.Content platforms call charts_trending to get soundCloud's trending chart (all music), ranked, each track with its trending score.limit
charts_top50The official SoundCloud Top 50 for the US or the UK, overall or by genre ("Music Charts" playlists, updated weekly), ranked, every track in full. `charts_list` lists the charts each country has.Research tools call charts_top50 to get the official SoundCloud Top 50 for the US or the UK, overall or by genre ("Music Charts" play….country, chart
charts_listEvery chart this API can return: the US and UK Top 50 lists (slug, title, track count, last update) and the genres of the trending-by-genre lists.Community analysts call charts_list to get every chart this API can return.none
trending_by_genreSoundCloud's trending list for one genre (the "Trending by genre" shelf on Discover), every track in full.Media monitors call trending_by_genre to get soundCloud's trending list for one genre (the "Trending by genre" shelf on Discover), every t….genre, page, limit
discoverSoundCloud's Discover page shelves for a logged-out visitor: "Artists to watch out for" (Buzzing), "Curated by SoundCloud" and "Trending by genre", each with its playlists.Content platforms call discover to get soundCloud's Discover page shelves for a logged-out visitor.none
featured_tracksThe tracks SoundCloud features on its front page, in full.Research tools call featured_tracks to get the tracks SoundCloud features on its front page, in full..none
new_tracksNewest uploads carrying a tag or genre, newest first.Community analysts call new_tracks to get newest uploads carrying a tag or genre, newest first..tag, limit, cursor
resolveAny SoundCloud link (track, profile, playlist, album, station, short link) → what it is and the full record.Media monitors call resolve to get any SoundCloud link (track, profile, playlist, album, station, short link) → what it is and t….link
embedSoundCloud's official oEmbed answer for a link: the iframe player code, the player URL, title, author and thumbnail.Content platforms call embed to get soundCloud's official oEmbed answer for a link.link, maxheight
Code samples

Call search from your stack

curl -X POST https://api.reefapi.com/soundcloud/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"house"}'
MCP one-liner
Ask your MCP-connected assistant: call reefapi.soundcloud.search with {"query":"house"}.
Use cases

Who uses this API and why

  • Track plays, likes, reposts and comments of a release every day, from the first hour.
  • Read the ISRC, UPC and label metadata of tracks for royalty matching and catalogue audits.
  • Find rising artists with the trending chart, the Top 50 lists and newest uploads per tag.
  • Collect a track's timed comments, likers and reposters, or an artist's followers, for audience research.
  • Search tracks by genre, length, date and license to source Creative Commons music.
FAQ

Questions developers ask before integrating

Do I need a SoundCloud account or a SoundCloud API key?

No. Everything is read logged out; you only need a ReefAPI key.

Can I get play counts for many tracks at once?

Yes. tracks_batch takes up to 50 track ids and returns all of them in one call (50 tracks in 0.9 seconds, measured). Ids SoundCloud no longer serves come back in not_found_ids.

Do I get the ISRC?

Yes, when the uploader entered it: the publisher block carries isrc, upc_or_ean, album_title, release_title, publisher, writer_composer and the ℗ and © lines. Label releases usually have it (10 of 10 in a drake search); bedroom uploads usually do not (0 of 10 for lofi).

How deep do followers, likers and comments go?

Every list pages with next_cursor until SoundCloud stops. Three pages of 50 followers gave 150 different accounts, three pages of a track's comments 83 different comments, and 5 pages of 200 followers 1,000 different accounts. A page can hold fewer rows than asked for because SoundCloud leaves out hidden items; next_cursor still continues without gaps.

How deep does search go?

SoundCloud serves the first 300 results of a query (up to 50 per page). Filters narrow a broad query below that: "house" has about 6.4 million tracks, 3,191 added in the past day and 710,333 under 2 minutes.

Which charts are included?

The official SoundCloud Top 50 for the US (10 lists: all music genres, New & Hot, Artist Pro, Hip Hop, Electronic, Pop, Rock, Folk, Latin, Country) and the UK (10 lists, including Dance, R&B and Indie), 50 tracks each, updated weekly; the trending chart (top 100, with trending score); and trending by genre for 20 genres.

Can I download or stream the audio?

No. The API returns metadata only: counts, credits, dates, comments, lists and the waveform. audio_formats lists the formats SoundCloud encodes the track in, without links.

What does a link I already have give me?

resolve takes any soundcloud.com, m.soundcloud.com, on.soundcloud.com or player link and returns whether it is a track, profile, playlist or station plus the full record. Every action also accepts the link directly.

What is the SoundCloud API?

SoundCloud API is a ReefAPI endpoint group for track plays, likes, reposts, comments and isrc, artist followers, playlists and albums, search with filters, us and uk top 50 and trending charts. It returns live JSON through POST requests under /soundcloud/v1.

Is the SoundCloud API free to try?

Yes. ReefAPI starts with 1,000 free credits, no card required. SoundCloud calls use the same shared credit balance as every other ReefAPI engine.

Do I need a SoundCloud login or account?

No login to SoundCloud is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.

How fresh is the SoundCloud data?

The page example is captured from a live track call, and production requests fetch live data through ReefAPI rather than a static sample.

How many credits does the SoundCloud API use?

SoundCloud actions currently cost 1-2 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.

Can I call SoundCloud from an AI assistant or MCP client?

Yes. Connect ReefAPI once through MCP and your assistant can call soundcloud actions with the same key, credit pool and JSON envelope used by normal REST requests.

docs / soundcloud

SoundCloud

Track plays, likes, reposts, comments and ISRC, artist followers, playlists and albums, search with filters, US and UK Top 50 and trending charts.

base /soundcloud/v141 endpoints
post/soundcloud/v1/track1 credit

Everything SoundCloud publishes about one track: play, like, repost, comment and download counts, label and publisher metadata (ISRC, UPC/EAN, album and release title, publisher, writer/composer, ℗ and © lines, explicit flag), genre, tags, license, duration, upload / release / display dates, artwork, waveform link, buy link, the uploader with follower count, and the audio formats it is transcoded to (no audio).

ParameterAllowed / rangeDescription
trackrequired—The SoundCloud track: its soundcloud.com link, its numeric id, its `soundcloud:tracks:<id>` URN, an on.soundcloud.com short link, or the bare path (`artist/track`).
Try in playground →
post/soundcloud/v1/tracks_batch1 credit

Up to 50 tracks in one call (SoundCloud answers all of them in one request), by numeric id or URN. Ids SoundCloud no longer serves come back in `not_found_ids`.

ParameterAllowed / rangeDescription
idsrequired—1-50 numeric track ids or `soundcloud:tracks:<id>` URNs (array, or one comma-separated string). Links are not accepted here — use `track` or `resolve` for a link.
Try in playground →
post/soundcloud/v1/track_comments1 credit

A track's comments, newest first, each with the position in the track it was left at (`timestamp_ms`, `position` m:ss) and the commenter. A page can hold fewer rows than `limit` (SoundCloud leaves hidden comments out); `next_cursor` still continues without gaps.

ParameterAllowed / rangeDescription
trackrequired—The SoundCloud track: its soundcloud.com link, its numeric id, its `soundcloud:tracks:<id>` URN, an on.soundcloud.com short link, or the bare path (`artist/track`).
limit = 50optional1–200Comments per page (1-200).
cursoroptional—`next_cursor` from the previous page; leave empty for the first page.
Try in playground →
post/soundcloud/v1/track_likers1 credit

Users who liked a track, most recent like first.

ParameterAllowed / rangeDescription
trackrequired—The SoundCloud track: its soundcloud.com link, its numeric id, its `soundcloud:tracks:<id>` URN, an on.soundcloud.com short link, or the bare path (`artist/track`).
limit = 50optional1–200Users per page (1-200).
cursoroptional—`next_cursor` from the previous page; leave empty for the first page.
Try in playground →
post/soundcloud/v1/track_reposters1 credit

Users who reposted a track, most recent first.

ParameterAllowed / rangeDescription
trackrequired—The SoundCloud track: its soundcloud.com link, its numeric id, its `soundcloud:tracks:<id>` URN, an on.soundcloud.com short link, or the bare path (`artist/track`).
limit = 50optional1–200Users per page (1-200).
cursoroptional—`next_cursor` from the previous page; leave empty for the first page.
Try in playground →
post/soundcloud/v1/track_playlists1 credit

Public playlists and/or albums that contain a track.

ParameterAllowed / rangeDescription
trackrequired—The SoundCloud track: its soundcloud.com link, its numeric id, its `soundcloud:tracks:<id>` URN, an on.soundcloud.com short link, or the bare path (`artist/track`).
type = alloptionalall · playlists · albumsPlaylists, albums or both.
limit = 10optional1–20Playlists per page (1-20).
cursoroptional—`next_cursor` from the previous page; leave empty for the first page.
Try in playground →
post/soundcloud/v1/track_station2 credits

The track's station — SoundCloud's endless mix seeded by the track — with every track in full, one page at a time.

ParameterAllowed / rangeDescription
trackrequired—The SoundCloud track: its soundcloud.com link, its numeric id, its `soundcloud:tracks:<id>` URN, an on.soundcloud.com short link, or the bare path (`artist/track`).
page = 1optional1–3001-based page number.
limit = 50optional1–50Tracks per page (1-50).
Try in playground →
post/soundcloud/v1/track_waveform2 credits

The waveform SoundCloud's player draws for a track: the sample heights as published (`samples`, integers 0..`height`) and the same values scaled to 0..1 (`samples_normalized`).

ParameterAllowed / rangeDescription
trackrequired—The SoundCloud track: its soundcloud.com link, its numeric id, its `soundcloud:tracks:<id>` URN, an on.soundcloud.com short link, or the bare path (`artist/track`).
Try in playground →
post/soundcloud/v1/user2 credits

A SoundCloud profile: follower, following, track, playlist, like, repost and comment counts, verified and Pro badges, full / first / last name, city, country, bio, avatar and banner, creation date, and every website / social link on the profile.

ParameterAllowed / rangeDescription
userrequired—The SoundCloud user: its soundcloud.com link, its numeric id, its `soundcloud:users:<id>` URN, an on.soundcloud.com short link, or the bare path (`username`).
Try in playground →
post/soundcloud/v1/user_web_profiles1 credit

The websites and social links listed on a profile.

ParameterAllowed / rangeDescription
userrequired—The SoundCloud user: its soundcloud.com link, its numeric id, its `soundcloud:users:<id>` URN, an on.soundcloud.com short link, or the bare path (`username`).
Try in playground →
post/soundcloud/v1/user_tracks1 credit

Every track a user uploaded, newest first.

ParameterAllowed / rangeDescription
userrequired—The SoundCloud user: its soundcloud.com link, its numeric id, its `soundcloud:users:<id>` URN, an on.soundcloud.com short link, or the bare path (`username`).
limit = 20optional1–50Tracks per page (1-50).
cursoroptional—`next_cursor` from the previous page; leave empty for the first page.
Try in playground →
post/soundcloud/v1/user_top_tracks1 credit

The profile's "Popular tracks" (SoundCloud ranks them; at most 50).

ParameterAllowed / rangeDescription
userrequired—The SoundCloud user: its soundcloud.com link, its numeric id, its `soundcloud:users:<id>` URN, an on.soundcloud.com short link, or the bare path (`username`).
limit = 50optional1–50Tracks per page (1-50).
Try in playground →
post/soundcloud/v1/user_playlists1 credit

A user's public playlists and/or albums.

ParameterAllowed / rangeDescription
userrequired—The SoundCloud user: its soundcloud.com link, its numeric id, its `soundcloud:users:<id>` URN, an on.soundcloud.com short link, or the bare path (`username`).
type = alloptionalall · playlists · albumsPlaylists, albums or both.
limit = 10optional1–20Playlists per page (1-20).
cursoroptional—`next_cursor` from the previous page; leave empty for the first page.
Try in playground →
post/soundcloud/v1/user_likes1 credit

Tracks and/or playlists a user liked, with the date of each like.

ParameterAllowed / rangeDescription
userrequired—The SoundCloud user: its soundcloud.com link, its numeric id, its `soundcloud:users:<id>` URN, an on.soundcloud.com short link, or the bare path (`username`).
type = alloptionalall · tracks · playlistsLiked tracks, liked playlists or both.
limit = 20optional1–50Likes per page (1-50).
cursoroptional—`next_cursor` from the previous page; leave empty for the first page.
Try in playground →
post/soundcloud/v1/user_reposts1 credit

Tracks and playlists a user reposted, with the repost date and caption.

ParameterAllowed / rangeDescription
userrequired—The SoundCloud user: its soundcloud.com link, its numeric id, its `soundcloud:users:<id>` URN, an on.soundcloud.com short link, or the bare path (`username`).
limit = 20optional1–50Reposts per page (1-50).
cursoroptional—`next_cursor` from the previous page; leave empty for the first page.
Try in playground →
post/soundcloud/v1/user_activity1 credit

A profile's feed as shown on soundcloud.com: its uploads and reposts (tracks and playlists), newest first, with type and date.

ParameterAllowed / rangeDescription
userrequired—The SoundCloud user: its soundcloud.com link, its numeric id, its `soundcloud:users:<id>` URN, an on.soundcloud.com short link, or the bare path (`username`).
limit = 20optional1–50Entries per page (1-50).
cursoroptional—`next_cursor` from the previous page; leave empty for the first page.
Try in playground →
post/soundcloud/v1/user_followers1 credit

A user's followers with their own follower counts, city and country.

ParameterAllowed / rangeDescription
userrequired—The SoundCloud user: its soundcloud.com link, its numeric id, its `soundcloud:users:<id>` URN, an on.soundcloud.com short link, or the bare path (`username`).
limit = 50optional1–200Users per page (1-200).
cursoroptional—`next_cursor` from the previous page; leave empty for the first page.
Try in playground →
post/soundcloud/v1/user_followings1 credit

Accounts a user follows.

ParameterAllowed / rangeDescription
userrequired—The SoundCloud user: its soundcloud.com link, its numeric id, its `soundcloud:users:<id>` URN, an on.soundcloud.com short link, or the bare path (`username`).
limit = 50optional1–200Users per page (1-200).
cursoroptional—`next_cursor` from the previous page; leave empty for the first page.
Try in playground →
post/soundcloud/v1/user_comments2 credits

Comments a user left, newest first, each with the track it is on.

ParameterAllowed / rangeDescription
userrequired—The SoundCloud user: its soundcloud.com link, its numeric id, its `soundcloud:users:<id>` URN, an on.soundcloud.com short link, or the bare path (`username`).
limit = 20optional1–50Comments per page (1-50).
cursoroptional—`next_cursor` from the previous page; leave empty for the first page.
Try in playground →
post/soundcloud/v1/user_spotlight1 credit

The tracks and playlists a profile pinned to its Spotlight.

ParameterAllowed / rangeDescription
userrequired—The SoundCloud user: its soundcloud.com link, its numeric id, its `soundcloud:users:<id>` URN, an on.soundcloud.com short link, or the bare path (`username`).
Try in playground →
post/soundcloud/v1/artist_station2 credits

The artist's station — SoundCloud's endless mix seeded by the profile — with every track in full, one page at a time.

ParameterAllowed / rangeDescription
userrequired—The SoundCloud user: its soundcloud.com link, its numeric id, its `soundcloud:users:<id>` URN, an on.soundcloud.com short link, or the bare path (`username`).
page = 1optional1–3001-based page number.
limit = 50optional1–50Tracks per page (1-50).
Try in playground →
post/soundcloud/v1/playlist2 credits

A playlist or album: title, owner, description, genre, tags, label, license, track count, total duration, like and repost counts, dates, artwork, every track id in order, and the first page of tracks in full.

ParameterAllowed / rangeDescription
playlistrequired—The SoundCloud playlist: its soundcloud.com link, its numeric id, its `soundcloud:playlists:<id>` URN, an on.soundcloud.com short link, or the bare path (`artist/sets/name`).
limit = 50optional1–50Tracks per page (1-50).
Try in playground →
post/soundcloud/v1/playlist_tracks2 credits

A playlist's or album's tracks in order, numbered, one page at a time (50 per page at most).

ParameterAllowed / rangeDescription
playlistrequired—The SoundCloud playlist: its soundcloud.com link, its numeric id, its `soundcloud:playlists:<id>` URN, an on.soundcloud.com short link, or the bare path (`artist/sets/name`).
page = 1optional1–3001-based page number.
limit = 50optional1–50Tracks per page (1-50).
Try in playground →
post/soundcloud/v1/playlist_likers1 credit

Users who liked a playlist or album.

ParameterAllowed / rangeDescription
playlistrequired—The SoundCloud playlist: its soundcloud.com link, its numeric id, its `soundcloud:playlists:<id>` URN, an on.soundcloud.com short link, or the bare path (`artist/sets/name`).
limit = 50optional1–200Users per page (1-200).
cursoroptional—`next_cursor` from the previous page; leave empty for the first page.
Try in playground →
post/soundcloud/v1/playlist_reposters1 credit

Users who reposted a playlist or album.

ParameterAllowed / rangeDescription
playlistrequired—The SoundCloud playlist: its soundcloud.com link, its numeric id, its `soundcloud:playlists:<id>` URN, an on.soundcloud.com short link, or the bare path (`artist/sets/name`).
limit = 50optional1–200Users per page (1-200).
cursoroptional—`next_cursor` from the previous page; leave empty for the first page.
Try in playground →
post/soundcloud/v1/search_tracks1 credit

Search tracks with SoundCloud's own filters: genre or tag, length, "Added" date and Creative Commons license. Returns the query's genre counts (`genre_counts`). SoundCloud serves the first 300 results; filters narrow a query below that.

ParameterAllowed / rangeDescription
queryrequired—Search words.
genreoptional—Genre or tag, as SoundCloud spells it (`techno`, `deep house`, `hip-hop & rap`, `lofi`); case does not matter. `genre_counts` in the answer lists the genres the query has, with counts.
durationoptionalshort · medium · long · epicTrack length band.
added_withinoptionallast_hour · last_day · last_week · last_month · last_yearSoundCloud's "Added" filter: the date the site shows on the track (`display_date`) is within this window. For a track made public or scheduled later this is after `created_at` (measured: past day → 44 of 50 rows also have `created_at` in the window, 50 of 50 `display_date`).
licenseoptionalto_share · to_use_commercially · to_modify_commerciallyCreative Commons use the uploader allows.
page = 1optional1–3001-based page number.
limit = 20optional1–50Tracks per page (1-50).
Try in playground →
post/soundcloud/v1/search_users1 credit

Search people and artists, optionally in one city. Returns the query's top cities with counts (`place_counts`); pass one back as `place`.

ParameterAllowed / rangeDescription
queryrequired—Search words.
placeoptional—City, as listed in `place_counts` (`berlin`, `los angeles`); case does not matter.
page = 1optional1–3001-based page number.
limit = 20optional1–50Users per page (1-50).
Try in playground →
post/soundcloud/v1/search_playlists1 credit

Search playlists and/or albums, optionally by genre or tag. Returns the query's genre counts.

ParameterAllowed / rangeDescription
queryrequired—Search words.
type = alloptionalall · playlists · albumsPlaylists, albums or both.
genreoptional—Genre or tag, as SoundCloud spells it (`techno`, `deep house`, `hip-hop & rap`, `lofi`); case does not matter. `genre_counts` in the answer lists the genres the query has, with counts.
page = 1optional1–3001-based page number.
limit = 10optional1–20Playlists per page (1-20).
Try in playground →
post/soundcloud/v1/autocomplete1 credit

What SoundCloud's search box suggests for the typed text: query completions and matching tags.

ParameterAllowed / rangeDescription
queryrequired—The text typed so far.
Try in playground →
post/soundcloud/v1/charts_top502 credits

The official SoundCloud Top 50 for the US or the UK, overall or by genre ("Music Charts" playlists, updated weekly), ranked, every track in full. `charts_list` lists the charts each country has.

ParameterAllowed / rangeDescription
country = USoptionalUS · GBUS or GB (UK works too).
chart = all-music-genresoptional—Chart slug: `all-music-genres`, `new-hot`, `artist-pro`, `hip-hop`, `electronic`, `pop`, `rock`, `folk`, `latin`, `country` (US) · `dance`, `r-b`, `indie` (UK) — `charts_list` has the live list.
Try in playground →
post/soundcloud/v1/charts_listfree

Every chart this API can return: the US and UK Top 50 lists (slug, title, track count, last update) and the genres of the trending-by-genre lists.

Try in playground →
post/soundcloud/v1/discoverfree

SoundCloud's Discover page shelves for a logged-out visitor: "Artists to watch out for" (Buzzing), "Curated by SoundCloud" and "Trending by genre", each with its playlists.

Try in playground →
post/soundcloud/v1/new_tracks1 credit

Newest uploads carrying a tag or genre, newest first.

ParameterAllowed / rangeDescription
tagrequired—Tag or genre (`techno`, `lofi`, `hiphoprap`).
limit = 20optional1–50Tracks per page (1-50).
cursoroptional—`next_cursor` from the previous page; leave empty for the first page.
Try in playground →
post/soundcloud/v1/resolve1 credit

Any SoundCloud link (track, profile, playlist, album, station, short link) → what it is and the full record.

ParameterAllowed / rangeDescription
linkrequired—soundcloud.com, m.soundcloud.com, on.soundcloud.com or player link, or a `soundcloud:` URN.
Try in playground →
post/soundcloud/v1/embed1 credit

SoundCloud's official oEmbed answer for a link: the iframe player code, the player URL, title, author and thumbnail.

ParameterAllowed / rangeDescription
linkrequired—A soundcloud.com track, profile or playlist link.
maxheightoptional50–1000Player height in pixels (166 = compact).
Try in playground →
Built for volume
5M+ requests a day

Measured at 60 requests a second across the fleet, with no central bottleneck. Volume pricing is on request, and per-key limits are raised for high-volume accounts.

Missing a source?
We build it

Tell us a site we do not cover yet and it becomes an engine. A customer asked for bestprice.gr on a Sunday and it was in the catalog the next day.

Support
2 minute median reply

Median time from a question in the live chat to the first answer, measured across every answered conversation. Setup help included, no support tier to buy.

One key, one balance
Every API included

No per-site plans and no separate subscriptions. One key and one credit pool across the whole catalog, so adding a source costs nothing up front.

Planning something large? Tell us the volume and the sources and we will come back with what it costs and what we would have to build.