SoundCloud API

Play counts, ISRC, followers and charts from SoundCloud, logged out

endpoints
41
credits per call
0–2

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

/soundcloud/v1

  • POST/soundcloud/v1/track1 credit
  • POST/soundcloud/v1/tracks_batch1 credit
  • POST/soundcloud/v1/track_comments1 credit
  • POST/soundcloud/v1/track_likers1 credit
  • POST/soundcloud/v1/track_reposters1 credit
  • POST/soundcloud/v1/track_related1 credit
  • POST/soundcloud/v1/track_playlists1 credit
  • POST/soundcloud/v1/track_station2 credits
  • POST/soundcloud/v1/track_waveform2 credits
  • POST/soundcloud/v1/user2 credits
41 active endpoints, on 0, 1 and 2 credit tiers.+31 more, every parameter ↓OpenAPI 3.0 spec ↗

1 credit per call≈ $1/1,000 calls1,000 free credits, no card

Get a free API key
Try it live

Run the call yourself, on the real endpoint

Change a parameter and press Try it. The response on the right is what your code will receive.

SoundCloud API

5 of 41 endpoints, ready to run

View docs ↗

Plays, likes, reposts, comments, ISRC and label of one track

1 credit1 required · 0 optional
POST/soundcloud/v1/track
idle
// Press "Try it" and this pane shows exactly what the
// live site returned this second — including an empty
// result, if that is the truth. No key, no account.

Try every endpoint in the playground

Endpoints

What SoundCloud endpoints does ReefAPI ship?

41 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.

  • track

    1 cr

    Everything SoundCloud publishes about one track.

    required
    track
    optional
    —
  • tracks_batch

    1 cr

    Up to 50 tracks in one call (SoundCloud answers all of them in one request), by numeric id or…

    required
    ids
    optional
    —
  • track_comments

    1 cr

    A track's comments, newest first, each with the position in the track it was left at (timesta…

    required
    track
    optional
    limit, cursor
  • track_likers

    1 cr

    Users who liked a track, most recent like first.

    required
    track
    optional
    limit, cursor
  • track_reposters

    1 cr

    Users who reposted a track, most recent first.

    required
    track
    optional
    limit, cursor
  • track_related

    1 cr

    Tracks SoundCloud recommends next to a track ("Related tracks").

    required
    track
    optional
    limit
  • track_playlists

    1 cr

    Public playlists and/or albums that contain a track.

    required
    track
    optional
    type, limit, cursor
  • track_station

    2 cr

    The track's station.

    required
    track
    optional
    page, limit
  • track_waveform

    2 cr

    The waveform SoundCloud's player draws for a track.

    required
    track
    optional
    —
  • user

    2 cr

    A SoundCloud profile.

    required
    user
    optional
    —
  • user_web_profiles

    1 cr

    The websites and social links listed on a profile.

    required
    user
    optional
    —
  • user_tracks

    1 cr

    Every track a user uploaded, newest first.

    required
    user
    optional
    limit, cursor
  • user_top_tracks

    1 cr

    The profile's "Popular tracks" (SoundCloud ranks them.

    required
    user
    optional
    limit
  • user_playlists

    1 cr

    A user's public playlists and/or albums.

    required
    user
    optional
    type, limit, cursor
  • user_likes

    1 cr

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

    required
    user
    optional
    type, limit, cursor
  • user_reposts

    1 cr

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

    required
    user
    optional
    limit, cursor
  • user_activity

    1 cr

    A profile's feed as shown on soundcloud.com.

    required
    user
    optional
    limit, cursor
  • user_followers

    1 cr

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

    required
    user
    optional
    limit, cursor
  • user_followings

    1 cr

    Accounts a user follows.

    required
    user
    optional
    limit, cursor
  • user_comments

    2 cr

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

    required
    user
    optional
    limit, cursor
  • user_related_artists

    1 cr

    SoundCloud's "Fans also like" artists for a profile (SoundCloud serves 10, measured).

    required
    user
    optional
    —
  • user_spotlight

    1 cr

    The tracks and playlists a profile pinned to its Spotlight.

    required
    user
    optional
    —
  • artist_station

    2 cr

    The artist's station.

    required
    user
    optional
    page, limit
  • playlist

    2 cr

    A playlist or album.

    required
    playlist
    optional
    limit
  • playlist_tracks

    2 cr

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

    required
    playlist
    optional
    page, limit
  • playlist_likers

    1 cr

    Users who liked a playlist or album.

    required
    playlist
    optional
    limit, cursor
  • playlist_reposters

    1 cr

    Users who reposted a playlist or album.

    required
    playlist
    optional
    limit, cursor
  • search

    1 cr

    Search everything (tracks, users, playlists and albums mixed, as SoundCloud's "Everything" tab).

    required
    query
    optional
    page, limit
  • search_tracks

    1 cr

    Search tracks with SoundCloud's own filters.

    required
    query
    optional
    genre, duration, added_within, license, page, limit
  • search_users

    1 cr

    Search people and artists, optionally in one city.

    required
    query
    optional
    place, page, limit
  • search_playlists

    1 cr

    Search playlists and/or albums, optionally by genre or tag.

    required
    query
    optional
    type, genre, page, limit
  • autocomplete

    1 cr

    What SoundCloud's search box suggests for the typed text.

    required
    query
    optional
    —
  • charts_trending

    1 cr

    SoundCloud's trending chart (all music), ranked, each track with its trending score.

    required
    —
    optional
    limit
  • charts_top50

    2 cr

    The official SoundCloud Top 50 for the US or the UK, overall or by genre ("Music Charts" play…

    required
    —
    optional
    country, chart
  • charts_list

    0 cr

    Every chart this API can return.

    required
    —
    optional
    —
  • trending_by_genre

    2 cr

    SoundCloud's trending list for one genre (the "Trending by genre" shelf on Discover), every t…

    required
    —
    optional
    genre, page, limit
  • discover

    0 cr

    SoundCloud's Discover page shelves for a logged-out visitor.

    required
    —
    optional
    —
  • featured_tracks

    2 cr

    The tracks SoundCloud features on its front page, in full.

    required
    —
    optional
    —
  • new_tracks

    1 cr

    Newest uploads carrying a tag or genre, newest first.

    required
    tag
    optional
    limit, cursor
  • resolve

    1 cr

    Any SoundCloud link (track, profile, playlist, album, station, short link) → what it is and t…

    required
    link
    optional
    —
  • embed

    1 cr

    SoundCloud's official oEmbed answer for a link.

    required
    link
    optional
    maxheight

Every parameter, every allowed value →

Missing a SoundCloud endpoint, or need a source we don't have yet?Contact us real people · same-day reply.
How it works

How the SoundCloud API works

SoundCloud is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.

Authenticate01
x-api-key header

No OAuth app, no request signing, no per-site account. One key covers all 694 engines.

Call02
POST /soundcloud/v1/…

Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.

Pay03
0 or 1 or 2 credits per call

Credits, not seats. Failed and blocked calls are never charged, and nothing is cached: every call reads the source live.

Read04
{ ok, data, meta, error }

One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.

Recipe

From a genre to the artists behind its rising tracks

Read the trending list for a genre, then open each track's artist and their audience.

01trending_by_genre?genre=hip-hop&limit=50
GET/soundcloud/v1/trending_by_genre?genre=hip-hop&limit=50

50 trending hip-hop tracks, ranked, each with plays, likes, reposts and the uploader.

02tracks_batch?ids=<id1>,<id2>,…
GET/soundcloud/v1/tracks_batch?ids=<id1>,<id2>,…

Up to 50 tracks again in one call, to re-read their counts on the next day.

03user?user=<username>
GET/soundcloud/v1/user?user=<username>

Followers, track count, city, country and the artist's social links.

04user_followers?user=<username>&limit=200
GET/soundcloud/v1/user_followers?user=<username>&limit=200

The artist's followers, 200 per page, with their own follower counts.

A dated list of a genre's rising tracks with their daily play growth and the profile and audience of each artist.

request
curl -X POST https://api.reefapi.com/soundcloud/v1/track \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"track":"https://soundcloud.com/forss/flickermood"}'
response envelope
{
  "ok": true,
  "data": { … },
  "meta": {
    "api": "soundcloud",
    "endpoint": "track",
    "mode": "live",
    "latency_ms": …,
    "record_count": …
  },
  "error": null
}
Fields

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.

Coverage

SoundCloud coverage, measured

Every number below was read from live SoundCloud on 2026-11-16, in 431 logged calls across the 41 actions.

Tracks

Play, like, repost, comment and download counts on 120 of 120 tracks across 10 genres. Counts equal to the track page's own numbers on 9 of 9 tracks. Genre on 86 of 120, tags on 51 of 120, ISRC on 30 of 100, label name on 24 of 120 (as uploaders enter them).

Profiles

Followers, followings, track, playlist, like and comment counts on 41 of 41 profiles; equal to the profile page on 9 of 9. City on 23 of 41, country on 18 of 41, social links on 12 of 16 profile details.

Lists

Followers, followings, likers, reposters, comments, a user's tracks, likes and activity: three consecutive pages each, no row repeated. A 416-track playlist read in pages of 20 with positions 1 to 60 and no gap.

Search

Up to 50 rows per page, the first 300 results of a query. "house" tracks: about 6.4 million; with genre techno about 1.1 million; under 2 minutes 710,333 (50 of 50 rows under 2 minutes); added in the past day 3,191; free to modify commercially 58,191. Users named "dj" in Berlin: 3,005.

United States

The official Top 50 in 10 lists (all music genres, New & Hot, Artist Pro, Hip Hop, Electronic, Pop, Rock, Folk, Latin, Country), 50 tracks each, every track in full.

United Kingdom

The official Top 50 in 10 lists (all music genres, New & Hot, Artist Pro, Rock, Dance, Hip Hop, R&B, Pop, Indie, Folk), 50 tracks each.

Worldwide

Trending top 100 with trending score; trending by genre for 20 genres (50 tracks each); Discover shelves (Buzzing, Curated by SoundCloud); front-page featured tracks; newest uploads for any tag.

Limits

Search stops at 300 results per query. Related tracks stop near 50 (46 measured), related artists at 10. A page of comments or likes can hold fewer rows than asked for. Broad searches can repeat a few tracks between consecutive pages ("house": 6 of 20 once, 0 in a second run). No audio.

Use cases

What people build with SoundCloud

The jobs this data is most often used for.

01

Track plays, likes, reposts and comments of a release every day, from the first hour.

02

Read the ISRC, UPC and label metadata of tracks for royalty matching and catalogue audits.

03

Find rising artists with the trending chart, the Top 50 lists and newest uploads per tag.

04

Collect a track's timed comments, likers and reposters, or an artist's followers, for audience research.

41

endpoints

0/1/2

credits per call

Pricing

What SoundCloud data costs

The cheapest call here is 0 credits, so $15/mo (Pro) buys 10,000 of them — $1.50 per 1,000 credits. Credits roll over and never expire, and failed or blocked calls are not charged.

$0.67–$1.50 / 1,000 credits
Full pricing →
  • 1,000 free credits on signup, no card
  • One key, all 694 APIs, one credit pool
  • Failed and blocked calls are never charged
  • Credits roll over and never expire
no credit card1,000 free credits · instant API key · pay by card or crypto
Quickstart

Call it in two lines

Sign up, get 1,000 credits and one key that works on every engine. Then this is the whole protocol.

curl
curl -X POST https://api.reefapi.com/soundcloud/v1/track \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"track":"https://soundcloud.com/forss/flickermood"}'
python
import os
import requests

REEF_KEY = os.environ["REEF_KEY"]

r = requests.post(
    "https://api.reefapi.com/soundcloud/v1/track",
    headers={"x-api-key": REEF_KEY},
    json={
        "track": "https://soundcloud.com/forss/flickermood"
    },
    timeout=90,
)
print(r.json()["data"])
FAQ

Have a question? We got answers.

The questions people actually ask before wiring up SoundCloud.

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.

Same key

43 Media, Film & Knowledge APIs on the same key

One key, one credit pool, one response envelope. If you are pulling SoundCloud, you are one call away from the rest of the category — no second contract, no second integration.

Contact

Need something this API does not do?

Name the endpoint, the field, or a source we do not carry yet. We ship new APIs every week and you would be first to get the key. Real people read every message and reply the same day.

0/4000

No account needed · we reply from [email protected]

Try it on your own data before you pay anything

The call above is the real endpoint, not a recording. A free key gives you 1,000 credits, the other 693 APIs, and the same envelope everywhere.

Endpoints, parameters and credit costs on this page are read from the live catalog and cannot drift from what the API accepts. Field notes were captured on 2026-11-16.