# SoundCloud API — track plays, likes, reposts, comments and ISRC, artist followers, playlists, albums, search with filters, Top 50 and trending charts

> 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).
> ReefAPI engine `soundcloud` · 41 endpoints · clean JSON, no scraping or browsers to manage.

## How to call
- **Endpoint:** `POST https://api.reefapi.com/soundcloud/v1/<action>` with a JSON body.
- **Auth:** header `x-api-key: <YOUR_REEFAPI_KEY>` — create one free (1,000 credits, no card): https://reefapi.com/signup
- **Response (every call):** `{ ok: boolean, data: ..., meta: { record_count, credits, ... }, error: { code, message } }` — branch on `ok`. Failed calls are free.
- **One key + one shared credit pool** across every ReefAPI API. Per-call credits are listed on each endpoint below.
- **Use it from an AI agent (MCP):** connect `https://api.reefapi.com/mcp` (remote streamable-http). Clients that add connectors by URL, such as ChatGPT and the Claude app, connect with OAuth 2.1 (the user pastes their key once on a ReefAPI page; discovery at `/.well-known/oauth-protected-resource/mcp`). Config files send the key as `Authorization: Bearer <key>`. `?key=<key>` in the URL also works as a last-resort fallback.

## Endpoints

### POST https://api.reefapi.com/soundcloud/v1/track — 1 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).

**Parameters:**
- `track` (string, required) — 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`).

**Returns:** track{id, urn, title, url, permalink, user{id, username, full_name, city, country_code, verified, followers_count, …}, artist, description, genre, tags[], label_name, license, duration_ms, duration, created_at, release_date, display_date, playback_count, likes_count, reposts_count, comment_count, download_count, artwork_url, waveform_url, publisher{isrc, upc_or_ean, album_title, release_title, publisher, writer_composer, p_line, c_line, explicit, …}, purchase_url, audio_formats[], …}

**Example request body:**
```json
{
  "track": "https://soundcloud.com/forss/flickermood"
}
```

### POST https://api.reefapi.com/soundcloud/v1/tracks_batch — 1 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`.

**Parameters:**
- `ids` (array, required) — 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.

**Returns:** results[]{id, urn, title, url, permalink, user{id, username, full_name, city, country_code, verified, followers_count, …}, artist, description, genre, tags[], label_name, license, duration_ms, duration, created_at, release_date, display_date, playback_count, likes_count, reposts_count, comment_count, download_count, artwork_url, waveform_url, publisher{isrc, upc_or_ean, album_title, release_title, publisher, writer_composer, p_line, c_line, explicit, …}, purchase_url, audio_formats[], …} + count + not_found_ids[]

**Example request body:**
```json
{
  "ids": "2410977027,293"
}
```

### POST https://api.reefapi.com/soundcloud/v1/track_comments — 1 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.

**Parameters:**
- `track` (string, required) — 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` (integer, optional, default 50) — Comments per page (1-200).
- `cursor` (string, optional) — `next_cursor` from the previous page; leave empty for the first page.

**Returns:** track{id, title, url, comment_count} + results[]{id, body, created_at, timestamp_ms, position, user{…}} + count + next_cursor + has_more

**Example request body:**
```json
{
  "track": "https://soundcloud.com/forss/flickermood"
}
```

### POST https://api.reefapi.com/soundcloud/v1/track_likers — 1 credit
Users who liked a track, most recent like first.

**Parameters:**
- `track` (string, required) — 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` (integer, optional, default 50) — Users per page (1-200).
- `cursor` (string, optional) — `next_cursor` from the previous page; leave empty for the first page.

**Returns:** track{id, title, url, likes_count} + results[]{id, urn, username, url, full_name, first_name, last_name, description, city, country_code, verified, badges{pro, pro_unlimited, creator_mid_tier, verified}, followers_count, followings_count, track_count, playlist_count, likes_count, playlist_likes_count, reposts_count, comments_count, created_at, avatar_url, banner_url, creator_subscription, …} + count + next_cursor + has_more

**Example request body:**
```json
{
  "track": "https://soundcloud.com/forss/flickermood"
}
```

### POST https://api.reefapi.com/soundcloud/v1/track_reposters — 1 credit
Users who reposted a track, most recent first.

**Parameters:**
- `track` (string, required) — 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` (integer, optional, default 50) — Users per page (1-200).
- `cursor` (string, optional) — `next_cursor` from the previous page; leave empty for the first page.

**Returns:** track{id, title, url, reposts_count} + results[]{id, urn, username, url, full_name, first_name, last_name, description, city, country_code, verified, badges{pro, pro_unlimited, creator_mid_tier, verified}, followers_count, followings_count, track_count, playlist_count, likes_count, playlist_likes_count, reposts_count, comments_count, created_at, avatar_url, banner_url, creator_subscription, …} + count + next_cursor + has_more

**Example request body:**
```json
{
  "track": "https://soundcloud.com/forss/flickermood"
}
```

### POST https://api.reefapi.com/soundcloud/v1/track_related — 1 credit
Tracks SoundCloud recommends next to a track ("Related tracks"). SoundCloud serves at most ~50 (measured: limit 100 → 46).

**Parameters:**
- `track` (string, required) — 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` (integer, optional, default 20) — Tracks per page (1-50).

**Returns:** track{id, title, url} + results[]{id, urn, title, url, permalink, user{id, username, full_name, city, country_code, verified, followers_count, …}, artist, description, genre, tags[], label_name, license, duration_ms, duration, created_at, release_date, display_date, playback_count, likes_count, reposts_count, comment_count, download_count, artwork_url, waveform_url, publisher{isrc, upc_or_ean, album_title, release_title, publisher, writer_composer, p_line, c_line, explicit, …}, purchase_url, audio_formats[], …} + count

**Example request body:**
```json
{
  "track": "https://soundcloud.com/forss/flickermood"
}
```

### POST https://api.reefapi.com/soundcloud/v1/track_playlists — 1 credit
Public playlists and/or albums that contain a track.

**Parameters:**
- `track` (string, required) — 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` (enum, optional, default "all") — Playlists, albums or both. [one of: all, playlists, albums]
- `limit` (integer, optional, default 10) — Playlists per page (1-20).
- `cursor` (string, optional) — `next_cursor` from the previous page; leave empty for the first page.

**Returns:** track{id, title, url} + results[]{id, urn, kind (playlist|album), title, url, user{…}, description, genre, tags[], label_name, license, is_album, set_type, track_count, duration_ms, likes_count, reposts_count, created_at, published_at, release_date, artwork_url, track_ids[], …} + count + next_cursor + has_more

**Example request body:**
```json
{
  "track": "https://soundcloud.com/forss/flickermood"
}
```

### POST https://api.reefapi.com/soundcloud/v1/track_station — 2 credits
The track's station — SoundCloud's endless mix seeded by the track — with every track in full, one page at a time.

**Parameters:**
- `track` (string, required) — 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` (integer, optional, default 1) — 1-based page number.
- `limit` (integer, optional, default 50) — Tracks per page (1-50).

**Returns:** station{urn, title, url, seed, track_count, …} + results[]{id, urn, title, url, permalink, user{id, username, full_name, city, country_code, verified, followers_count, …}, artist, description, genre, tags[], label_name, license, duration_ms, duration, created_at, release_date, display_date, playback_count, likes_count, reposts_count, comment_count, download_count, artwork_url, waveform_url, publisher{isrc, upc_or_ean, album_title, release_title, publisher, writer_composer, p_line, c_line, explicit, …}, purchase_url, audio_formats[], …} + page + limit + total + has_more + unavailable_ids[]

**Example request body:**
```json
{
  "track": "https://soundcloud.com/forss/flickermood"
}
```

### POST https://api.reefapi.com/soundcloud/v1/track_waveform — 2 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`).

**Parameters:**
- `track` (string, required) — 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`).

**Returns:** track{id, title, url, duration_ms} + width + height + sample_count + samples[] + samples_normalized[]

**Example request body:**
```json
{
  "track": "https://soundcloud.com/forss/flickermood"
}
```

### POST https://api.reefapi.com/soundcloud/v1/user — 2 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.

**Parameters:**
- `user` (string, required) — 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`).

**Returns:** user{id, urn, username, url, full_name, first_name, last_name, description, city, country_code, verified, badges{pro, pro_unlimited, creator_mid_tier, verified}, followers_count, followings_count, track_count, playlist_count, likes_count, playlist_likes_count, reposts_count, comments_count, created_at, avatar_url, banner_url, creator_subscription, …, web_profiles[]{network, title, url, username}}

**Example request body:**
```json
{
  "user": "forss"
}
```

### POST https://api.reefapi.com/soundcloud/v1/user_web_profiles — 1 credit
The websites and social links listed on a profile.

**Parameters:**
- `user` (string, required) — 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`).

**Returns:** user{id, username, url} + results[]{network, title, url, username, …} + count

**Example request body:**
```json
{
  "user": "forss"
}
```

### POST https://api.reefapi.com/soundcloud/v1/user_tracks — 1 credit
Every track a user uploaded, newest first.

**Parameters:**
- `user` (string, required) — 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` (integer, optional, default 20) — Tracks per page (1-50).
- `cursor` (string, optional) — `next_cursor` from the previous page; leave empty for the first page.

**Returns:** user{id, username, url, track_count} + results[]{id, urn, title, url, permalink, user{id, username, full_name, city, country_code, verified, followers_count, …}, artist, description, genre, tags[], label_name, license, duration_ms, duration, created_at, release_date, display_date, playback_count, likes_count, reposts_count, comment_count, download_count, artwork_url, waveform_url, publisher{isrc, upc_or_ean, album_title, release_title, publisher, writer_composer, p_line, c_line, explicit, …}, purchase_url, audio_formats[], …} + count + next_cursor + has_more

**Example request body:**
```json
{
  "user": "forss"
}
```

### POST https://api.reefapi.com/soundcloud/v1/user_top_tracks — 1 credit
The profile's "Popular tracks" (SoundCloud ranks them; at most 50).

**Parameters:**
- `user` (string, required) — 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` (integer, optional, default 50) — Tracks per page (1-50).

**Returns:** user{id, username, url} + results[]{id, urn, title, url, permalink, user{id, username, full_name, city, country_code, verified, followers_count, …}, artist, description, genre, tags[], label_name, license, duration_ms, duration, created_at, release_date, display_date, playback_count, likes_count, reposts_count, comment_count, download_count, artwork_url, waveform_url, publisher{isrc, upc_or_ean, album_title, release_title, publisher, writer_composer, p_line, c_line, explicit, …}, purchase_url, audio_formats[], …} + count

**Example request body:**
```json
{
  "user": "forss"
}
```

### POST https://api.reefapi.com/soundcloud/v1/user_playlists — 1 credit
A user's public playlists and/or albums.

**Parameters:**
- `user` (string, required) — 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` (enum, optional, default "all") — Playlists, albums or both. [one of: all, playlists, albums]
- `limit` (integer, optional, default 10) — Playlists per page (1-20).
- `cursor` (string, optional) — `next_cursor` from the previous page; leave empty for the first page.

**Returns:** user{id, username, url, playlist_count} + results[]{id, urn, kind (playlist|album), title, url, user{…}, description, genre, tags[], label_name, license, is_album, set_type, track_count, duration_ms, likes_count, reposts_count, created_at, published_at, release_date, artwork_url, track_ids[], …} + count + next_cursor + has_more

**Example request body:**
```json
{
  "user": "forss"
}
```

### POST https://api.reefapi.com/soundcloud/v1/user_likes — 1 credit
Tracks and/or playlists a user liked, with the date of each like.

**Parameters:**
- `user` (string, required) — 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` (enum, optional, default "all") — Liked tracks, liked playlists or both. [one of: all, tracks, playlists]
- `limit` (integer, optional, default 20) — Likes per page (1-50).
- `cursor` (string, optional) — `next_cursor` from the previous page; leave empty for the first page.

**Returns:** user{id, username, url, likes_count} + results[]{type, liked_at, track|playlist} + count + next_cursor + has_more

**Example request body:**
```json
{
  "user": "forss"
}
```

### POST https://api.reefapi.com/soundcloud/v1/user_reposts — 1 credit
Tracks and playlists a user reposted, with the repost date and caption.

**Parameters:**
- `user` (string, required) — 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` (integer, optional, default 20) — Reposts per page (1-50).
- `cursor` (string, optional) — `next_cursor` from the previous page; leave empty for the first page.

**Returns:** user{id, username, url} + results[]{type, created_at, caption, track|playlist, by} + count + next_cursor + has_more

**Example request body:**
```json
{
  "user": "forss"
}
```

### POST https://api.reefapi.com/soundcloud/v1/user_activity — 1 credit
A profile's feed as shown on soundcloud.com: its uploads and reposts (tracks and playlists), newest first, with type and date.

**Parameters:**
- `user` (string, required) — 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` (integer, optional, default 20) — Entries per page (1-50).
- `cursor` (string, optional) — `next_cursor` from the previous page; leave empty for the first page.

**Returns:** user{id, username, url} + results[]{type (track|track-repost|playlist|playlist-repost), created_at, caption, track|playlist, by} + count + next_cursor + has_more

**Example request body:**
```json
{
  "user": "forss"
}
```

### POST https://api.reefapi.com/soundcloud/v1/user_followers — 1 credit
A user's followers with their own follower counts, city and country.

**Parameters:**
- `user` (string, required) — 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` (integer, optional, default 50) — Users per page (1-200).
- `cursor` (string, optional) — `next_cursor` from the previous page; leave empty for the first page.

**Returns:** user{id, username, url, followers_count} + results[]{id, urn, username, url, full_name, first_name, last_name, description, city, country_code, verified, badges{pro, pro_unlimited, creator_mid_tier, verified}, followers_count, followings_count, track_count, playlist_count, likes_count, playlist_likes_count, reposts_count, comments_count, created_at, avatar_url, banner_url, creator_subscription, …} + count + next_cursor + has_more

**Example request body:**
```json
{
  "user": "octobersveryown",
  "limit": 20
}
```

### POST https://api.reefapi.com/soundcloud/v1/user_followings — 1 credit
Accounts a user follows.

**Parameters:**
- `user` (string, required) — 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` (integer, optional, default 50) — Users per page (1-200).
- `cursor` (string, optional) — `next_cursor` from the previous page; leave empty for the first page.

**Returns:** user{id, username, url, followings_count} + results[]{id, urn, username, url, full_name, first_name, last_name, description, city, country_code, verified, badges{pro, pro_unlimited, creator_mid_tier, verified}, followers_count, followings_count, track_count, playlist_count, likes_count, playlist_likes_count, reposts_count, comments_count, created_at, avatar_url, banner_url, creator_subscription, …} + count + next_cursor + has_more

**Example request body:**
```json
{
  "user": "forss"
}
```

### POST https://api.reefapi.com/soundcloud/v1/user_comments — 2 credits
Comments a user left, newest first, each with the track it is on.

**Parameters:**
- `user` (string, required) — 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` (integer, optional, default 20) — Comments per page (1-50).
- `cursor` (string, optional) — `next_cursor` from the previous page; leave empty for the first page.

**Returns:** user{id, username, url, comments_count} + results[]{id, body, created_at, timestamp_ms, position, track{…}} + count + next_cursor + has_more

**Example request body:**
```json
{
  "user": "forss"
}
```

### POST https://api.reefapi.com/soundcloud/v1/user_related_artists — 1 credit
SoundCloud's "Fans also like" artists for a profile (SoundCloud serves 10, measured).

**Parameters:**
- `user` (string, required) — 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`).

**Returns:** user{id, username, url} + results[]{id, urn, username, url, full_name, first_name, last_name, description, city, country_code, verified, badges{pro, pro_unlimited, creator_mid_tier, verified}, followers_count, followings_count, track_count, playlist_count, likes_count, playlist_likes_count, reposts_count, comments_count, created_at, avatar_url, banner_url, creator_subscription, …} + count

**Example request body:**
```json
{
  "user": "forss"
}
```

### POST https://api.reefapi.com/soundcloud/v1/user_spotlight — 1 credit
The tracks and playlists a profile pinned to its Spotlight.

**Parameters:**
- `user` (string, required) — 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`).

**Returns:** user{id, username, url} + results[]{track or playlist} + count

**Example request body:**
```json
{
  "user": "forss"
}
```

### POST https://api.reefapi.com/soundcloud/v1/artist_station — 2 credits
The artist's station — SoundCloud's endless mix seeded by the profile — with every track in full, one page at a time.

**Parameters:**
- `user` (string, required) — 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` (integer, optional, default 1) — 1-based page number.
- `limit` (integer, optional, default 50) — Tracks per page (1-50).

**Returns:** station{urn, title, url, seed, track_count, …} + results[]{id, urn, title, url, permalink, user{id, username, full_name, city, country_code, verified, followers_count, …}, artist, description, genre, tags[], label_name, license, duration_ms, duration, created_at, release_date, display_date, playback_count, likes_count, reposts_count, comment_count, download_count, artwork_url, waveform_url, publisher{isrc, upc_or_ean, album_title, release_title, publisher, writer_composer, p_line, c_line, explicit, …}, purchase_url, audio_formats[], …} + page + limit + total + has_more + unavailable_ids[]

**Example request body:**
```json
{
  "user": "forss"
}
```

### POST https://api.reefapi.com/soundcloud/v1/playlist — 2 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.

**Parameters:**
- `playlist` (string, required) — 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` (integer, optional, default 50) — Tracks per page (1-50).

**Returns:** playlist{id, urn, kind (playlist|album), title, url, user{…}, description, genre, tags[], label_name, license, is_album, set_type, track_count, duration_ms, likes_count, reposts_count, created_at, published_at, release_date, artwork_url, track_ids[], …} + results[]{id, urn, title, url, permalink, user{id, username, full_name, city, country_code, verified, followers_count, …}, artist, description, genre, tags[], label_name, license, duration_ms, duration, created_at, release_date, display_date, playback_count, likes_count, reposts_count, comment_count, download_count, artwork_url, waveform_url, publisher{isrc, upc_or_ean, album_title, release_title, publisher, writer_composer, p_line, c_line, explicit, …}, purchase_url, audio_formats[], …} + page + limit + total + has_more + unavailable_ids[]

**Example request body:**
```json
{
  "playlist": "https://soundcloud.com/music-charts-us/sets/all-music-genres"
}
```

### POST https://api.reefapi.com/soundcloud/v1/playlist_tracks — 2 credits
A playlist's or album's tracks in order, numbered, one page at a time (50 per page at most).

**Parameters:**
- `playlist` (string, required) — 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` (integer, optional, default 1) — 1-based page number.
- `limit` (integer, optional, default 50) — Tracks per page (1-50).

**Returns:** playlist{id, title, url, track_count} + results[]{position, …id, urn, title, url, permalink, user{id, username, full_name, city, country_code, verified, followers_count, …}, artist, description, genre, tags[], label_name, license, duration_ms, duration, created_at, release_date, display_date, playback_count, likes_count, reposts_count, comment_count, download_count, artwork_url, waveform_url, publisher{isrc, upc_or_ean, album_title, release_title, publisher, writer_composer, p_line, c_line, explicit, …}, purchase_url, audio_formats[], …} + page + limit + total + has_more + unavailable_ids[]

**Example request body:**
```json
{
  "playlist": "https://soundcloud.com/music-charts-us/sets/all-music-genres"
}
```

### POST https://api.reefapi.com/soundcloud/v1/playlist_likers — 1 credit
Users who liked a playlist or album.

**Parameters:**
- `playlist` (string, required) — 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` (integer, optional, default 50) — Users per page (1-200).
- `cursor` (string, optional) — `next_cursor` from the previous page; leave empty for the first page.

**Returns:** playlist{id, title, url, likes_count} + results[]{id, urn, username, url, full_name, first_name, last_name, description, city, country_code, verified, badges{pro, pro_unlimited, creator_mid_tier, verified}, followers_count, followings_count, track_count, playlist_count, likes_count, playlist_likes_count, reposts_count, comments_count, created_at, avatar_url, banner_url, creator_subscription, …} + count + next_cursor + has_more

**Example request body:**
```json
{
  "playlist": "https://soundcloud.com/music-charts-us/sets/all-music-genres"
}
```

### POST https://api.reefapi.com/soundcloud/v1/playlist_reposters — 1 credit
Users who reposted a playlist or album.

**Parameters:**
- `playlist` (string, required) — 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` (integer, optional, default 50) — Users per page (1-200).
- `cursor` (string, optional) — `next_cursor` from the previous page; leave empty for the first page.

**Returns:** playlist{id, title, url, reposts_count} + results[]{id, urn, username, url, full_name, first_name, last_name, description, city, country_code, verified, badges{pro, pro_unlimited, creator_mid_tier, verified}, followers_count, followings_count, track_count, playlist_count, likes_count, playlist_likes_count, reposts_count, comments_count, created_at, avatar_url, banner_url, creator_subscription, …} + count + next_cursor + has_more

**Example request body:**
```json
{
  "playlist": "https://soundcloud.com/music-charts-us/sets/all-music-genres"
}
```

### POST https://api.reefapi.com/soundcloud/v1/search — 1 credit
Search 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.

**Parameters:**
- `query` (string, required) — Search words.
- `page` (integer, optional, default 1) — 1-based page number.
- `limit` (integer, optional, default 20) — Results per page (1-50).

**Returns:** results[]{kind + track, user or playlist fields} + total_estimate + page + limit + has_more

**Example request body:**
```json
{
  "query": "house"
}
```

### POST https://api.reefapi.com/soundcloud/v1/search_tracks — 1 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.

**Parameters:**
- `query` (string, required) — Search words.
- `genre` (string, optional) — 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.
- `duration` (enum, optional) — Track length band. [one of: short, medium, long, epic]
- `added_within` (enum, optional) — SoundCloud'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`). [one of: last_hour, last_day, last_week, last_month, last_year]
- `license` (enum, optional) — Creative Commons use the uploader allows. [one of: to_share, to_use_commercially, to_modify_commercially]
- `page` (integer, optional, default 1) — 1-based page number.
- `limit` (integer, optional, default 20) — Tracks per page (1-50).

**Returns:** results[]{id, urn, title, url, permalink, user{id, username, full_name, city, country_code, verified, followers_count, …}, artist, description, genre, tags[], label_name, license, duration_ms, duration, created_at, release_date, display_date, playback_count, likes_count, reposts_count, comment_count, download_count, artwork_url, waveform_url, publisher{isrc, upc_or_ean, album_title, release_title, publisher, writer_composer, p_line, c_line, explicit, …}, purchase_url, audio_formats[], …} + genre_counts[]{value, count} + total_estimate + page + limit + has_more

**Example request body:**
```json
{
  "query": "house",
  "genre": "techno"
}
```

### POST https://api.reefapi.com/soundcloud/v1/search_users — 1 credit
Search people and artists, optionally in one city. Returns the query's top cities with counts (`place_counts`); pass one back as `place`.

**Parameters:**
- `query` (string, required) — Search words.
- `place` (string, optional) — City, as listed in `place_counts` (`berlin`, `los angeles`); case does not matter.
- `page` (integer, optional, default 1) — 1-based page number.
- `limit` (integer, optional, default 20) — Users per page (1-50).

**Returns:** results[]{id, urn, username, url, full_name, first_name, last_name, description, city, country_code, verified, badges{pro, pro_unlimited, creator_mid_tier, verified}, followers_count, followings_count, track_count, playlist_count, likes_count, playlist_likes_count, reposts_count, comments_count, created_at, avatar_url, banner_url, creator_subscription, …} + place_counts[]{value, count} + total_estimate + page + limit + has_more

**Example request body:**
```json
{
  "query": "house"
}
```

### POST https://api.reefapi.com/soundcloud/v1/search_playlists — 1 credit
Search playlists and/or albums, optionally by genre or tag. Returns the query's genre counts.

**Parameters:**
- `query` (string, required) — Search words.
- `type` (enum, optional, default "all") — Playlists, albums or both. [one of: all, playlists, albums]
- `genre` (string, optional) — 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` (integer, optional, default 1) — 1-based page number.
- `limit` (integer, optional, default 10) — Playlists per page (1-20).

**Returns:** results[]{id, urn, kind (playlist|album), title, url, user{…}, description, genre, tags[], label_name, license, is_album, set_type, track_count, duration_ms, likes_count, reposts_count, created_at, published_at, release_date, artwork_url, track_ids[], …} + genre_counts[] + total_estimate + page + limit + has_more

**Example request body:**
```json
{
  "query": "house"
}
```

### POST https://api.reefapi.com/soundcloud/v1/autocomplete — 1 credit
What SoundCloud's search box suggests for the typed text: query completions and matching tags.

**Parameters:**
- `query` (string, required) — The text typed so far.

**Returns:** query + suggestions[] + tags[]{tag, score}

**Example request body:**
```json
{
  "query": "house"
}
```

### POST https://api.reefapi.com/soundcloud/v1/charts_trending — 1 credit
SoundCloud's trending chart (all music), ranked, each track with its trending score. SoundCloud serves the top 100.

**Parameters:**
- `limit` (integer, optional, default 50) — Tracks per page (1-100).

**Returns:** chart{kind, genre, last_updated} + results[]{rank, score, …id, urn, title, url, permalink, user{id, username, full_name, city, country_code, verified, followers_count, …}, artist, description, genre, tags[], label_name, license, duration_ms, duration, created_at, release_date, display_date, playback_count, likes_count, reposts_count, comment_count, download_count, artwork_url, waveform_url, publisher{isrc, upc_or_ean, album_title, release_title, publisher, writer_composer, p_line, c_line, explicit, …}, purchase_url, audio_formats[], …} + count

**Example request body:**
```json
{
  "limit": 50
}
```

### POST https://api.reefapi.com/soundcloud/v1/charts_top50 — 2 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.

**Parameters:**
- `country` (enum, optional, default "US") — US or GB (UK works too). [one of: US, GB]
- `chart` (string, optional, default "all-music-genres") — 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.

**Returns:** chart{country, chart, title, url, last_modified, track_count} + results[]{rank, …id, urn, title, url, permalink, user{id, username, full_name, city, country_code, verified, followers_count, …}, artist, description, genre, tags[], label_name, license, duration_ms, duration, created_at, release_date, display_date, playback_count, likes_count, reposts_count, comment_count, download_count, artwork_url, waveform_url, publisher{isrc, upc_or_ean, album_title, release_title, publisher, writer_composer, p_line, c_line, explicit, …}, purchase_url, audio_formats[], …} + count + unavailable_ids[]

**Example request body:**
```json
{
  "country": "US"
}
```

### POST https://api.reefapi.com/soundcloud/v1/charts_list — 0 credits
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.

**Parameters:** none

**Returns:** top50{US[]{chart, title, id, url, track_count, last_modified}, GB[]{…}} + trending_genres[]{genre, title, urn, url}

### POST https://api.reefapi.com/soundcloud/v1/trending_by_genre — 2 credits
SoundCloud's trending list for one genre (the "Trending by genre" shelf on Discover), every track in full.

**Parameters:**
- `genre` (string, optional, default "all-genres") — Genre slug: `all-genres`, `trap`, `hip-hop`, `pop`, `electronic`, `r-n-b`, `alternative-hip-hop`, `indie`, `dubstep`, `house`, `folk`, `ambient`, `alternative-rock`, `hardcore`, `rock`, `reggae`, `latin`, `metal`, `dancehall`, `downtempo`.
- `page` (integer, optional, default 1) — 1-based page number.
- `limit` (integer, optional, default 50) — Tracks per page (1-50).

**Returns:** playlist{urn, title, url, track_count, …} + results[]{rank, …} + page + limit + total + has_more + unavailable_ids[]

**Example request body:**
```json
{
  "genre": "hip-hop"
}
```

### POST https://api.reefapi.com/soundcloud/v1/discover — 0 credits
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.

**Parameters:** none

**Returns:** shelves[]{urn, title, description, items[]{playlist fields}, count} + count

### POST https://api.reefapi.com/soundcloud/v1/featured_tracks — 2 credits
The tracks SoundCloud features on its front page, in full.

**Parameters:** none

**Returns:** results[]{id, urn, title, url, permalink, user{id, username, full_name, city, country_code, verified, followers_count, …}, artist, description, genre, tags[], label_name, license, duration_ms, duration, created_at, release_date, display_date, playback_count, likes_count, reposts_count, comment_count, download_count, artwork_url, waveform_url, publisher{isrc, upc_or_ean, album_title, release_title, publisher, writer_composer, p_line, c_line, explicit, …}, purchase_url, audio_formats[], …} + count + unavailable_ids[]

### POST https://api.reefapi.com/soundcloud/v1/new_tracks — 1 credit
Newest uploads carrying a tag or genre, newest first.

**Parameters:**
- `tag` (string, required) — Tag or genre (`techno`, `lofi`, `hiphoprap`).
- `limit` (integer, optional, default 20) — Tracks per page (1-50).
- `cursor` (string, optional) — `next_cursor` from the previous page; leave empty for the first page.

**Returns:** tag + results[]{id, urn, title, url, permalink, user{id, username, full_name, city, country_code, verified, followers_count, …}, artist, description, genre, tags[], label_name, license, duration_ms, duration, created_at, release_date, display_date, playback_count, likes_count, reposts_count, comment_count, download_count, artwork_url, waveform_url, publisher{isrc, upc_or_ean, album_title, release_title, publisher, writer_composer, p_line, c_line, explicit, …}, purchase_url, audio_formats[], …} + count + next_cursor + has_more

**Example request body:**
```json
{
  "tag": "techno"
}
```

### POST https://api.reefapi.com/soundcloud/v1/resolve — 1 credit
Any SoundCloud link (track, profile, playlist, album, station, short link) → what it is and the full record.

**Parameters:**
- `link` (string, required) — soundcloud.com, m.soundcloud.com, on.soundcloud.com or player link, or a `soundcloud:` URN.

**Returns:** input + kind + id + urn + url + record{track, user or playlist fields}

**Example request body:**
```json
{
  "link": "https://soundcloud.com/octobersveryown/quebec"
}
```

### POST https://api.reefapi.com/soundcloud/v1/embed — 1 credit
SoundCloud's official oEmbed answer for a link: the iframe player code, the player URL, title, author and thumbnail.

**Parameters:**
- `link` (string, required) — A soundcloud.com track, profile or playlist link.
- `maxheight` (integer, optional) — Player height in pixels (166 = compact).

**Returns:** title + author_name + author_url + thumbnail_url + player_url + embed_html + width + height

**Example request body:**
```json
{
  "link": "https://soundcloud.com/octobersveryown/quebec"
}
```

## At scale
- **Volume:** 5M+ requests a day, measured at 60 requests a second across the fleet with no
  central bottleneck. Per-key limits are raised for high-volume accounts; volume pricing on request.
- **Missing a source:** tell us a site we do not cover and it becomes an engine. A customer asked
  for bestprice.gr on 21 Sep 2026 and it was in the catalog on 22 Sep.
- **Support:** 2 minute median time from a question in the live chat to the first answer. Setup
  help included, no support tier to buy.
- **One key, one credit pool** across every API. No per-site plans, no separate subscriptions.

## More
- Try it live, no code: https://reefapi.com/playground?engine=soundcloud
- Human docs page: https://reefapi.com/docs/soundcloud
- Overview page: https://reefapi.com/soundcloud-api
- Every ReefAPI API in one file (for your AI): https://reefapi.com/llms-full.txt
