SoundCloud Artist Tracks API. Tracks, page by page.
Newest first, with exact plays and ISRC. We handle the proxies, blocks and platform changes.
SoundCloud Artist Tracks API at a glance
Returns a SoundCloud artist's public tracks, newest first, a page at a time, from its name, link, URN or ID. Each track has the same fields as the SoundCloud Track API: exact play, like, repost, comment and download counts, title, description, artwork, length, dates, genre, tags, license and the ISRC, label and UPC that labels fill in. Filter by date with since and until.
GET /v1/soundcloud/tracks
- 1 credit per page, $0.75–$1.97 per 1,000 pages
- 22 typed fields null when unknown
- 50 tracks per page, newest first
handleis all it needs, e.g.forss
Send one request. Get up to 50 tracks back.
Copy the request in your language, or hand it to your agent. Sign up for an API key and your first 100 credits are free.
$ npm install socialtaphandle = forssconst params = new URLSearchParams({
handle: "forss",
});
const res = await fetch(`https://socialtap.dev/v1/soundcloud/tracks?${params}`, {
headers: { "x-api-key": process.env.SOCIALTAP_API_KEY ?? "" },
});
const body = await res.json();
if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`);
const { data, page, meta } = body;
console.log(data, meta.credits_charged);import os
import requests
res = requests.get(
"https://socialtap.dev/v1/soundcloud/tracks",
params={"handle": "forss"},
headers={"x-api-key": os.environ["SOCIALTAP_API_KEY"]},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
data, page, meta = body["data"], body["page"], body["meta"]
print(data, meta["credits_charged"])require "json"
require "net/http"
uri = URI("https://socialtap.dev/v1/soundcloud/tracks")
uri.query = URI.encode_www_form('handle' => 'forss')
req = Net::HTTP::Get.new(uri)
req["x-api-key"] = ENV.fetch("SOCIALTAP_API_KEY")
res = Net::HTTP.start(uri.host, uri.port, use_ssl: uri.scheme == "https") { |http| http.request(req) }
body = JSON.parse(res.body)
raise "#{body["error"]["code"]}: #{body["error"]["message"]}" unless res.is_a?(Net::HTTPSuccess)
pp body["data"]
puts body["meta"]["credits_charged"]<?php
$query = http_build_query([
'handle' => 'forss',
]);
$ch = curl_init('https://socialtap.dev/v1/soundcloud/tracks?' . $query);
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['x-api-key: ' . getenv('SOCIALTAP_API_KEY')],
]);
$body = json_decode(curl_exec($ch), true);
if (curl_getinfo($ch, CURLINFO_RESPONSE_CODE) >= 400) {
throw new RuntimeException($body['error']['code'] . ': ' . $body['error']['message']);
}
print_r($body['data']);
echo $body['meta']['credits_charged'], PHP_EOL;package main
import (
"encoding/json"
"fmt"
"log"
"net/http"
"net/url"
"os"
)
func main() {
q := url.Values{}
q.Set("handle", "forss")
req, err := http.NewRequest("GET", "https://socialtap.dev/v1/soundcloud/tracks?"+q.Encode(), nil)
if err != nil {
log.Fatal(err)
}
req.Header.Set("x-api-key", os.Getenv("SOCIALTAP_API_KEY"))
res, err := http.DefaultClient.Do(req)
if err != nil {
log.Fatal(err)
}
defer res.Body.Close()
var body struct {
Data json.RawMessage `json:"data"`
Page json.RawMessage `json:"page"`
Meta map[string]any `json:"meta"`
Error *struct {
Code string `json:"code"`
Message string `json:"message"`
} `json:"error"`
}
if err := json.NewDecoder(res.Body).Decode(&body); err != nil {
log.Fatal(err)
}
if body.Error != nil {
log.Fatalf("%s: %s", body.Error.Code, body.Error.Message)
}
fmt.Println(string(body.Data), body.Meta["credits_charged"])
}curl 'https://socialtap.dev/v1/soundcloud/tracks?handle=forss' \
-H "x-api-key: $SOCIALTAP_API_KEY"{
"data": [
{
"approximate_fields": [],
"author": {
"avatar_url": "https://i1.sndcdn.com/avatars-000012778523-59quu3-t500x500.jpg",
"display_name": "Forss",
"id": "183",
"is_verified": true,
"url": "https://soundcloud.com/forss",
"username": "forss"
},
"coauthors": [],
"duration_ms": 370348,
"hashtags": [],
"id": "49438146",
"is_nsfw": null,
"is_pinned": null,
"is_sponsored": null,
"language": null,
"media": [
{
"alt_text": null,
"duration_ms": 370201,
"expires_at": null,
"height": null,
"thumbnail_url": "https://i1.sndcdn.com/artworks-000024916496-q9opo6-t500x500.jpg",
"type": "audio",
"url": null,
"width": null
}
],
"mentions": [],
"metrics": {
"comment_count": 408,
"like_count": 4707,
"quote_count": null,
"repost_count": 709,
"save_count": null,
"share_count": null,
"view_count": 229618
},
"platform": "soundcloud",
"platform_specific": {
"soundcloud": {
"album_title": null,
"artist_name": "Forss",
"author_follower_count": 132108,
"c_line": null,
"caption": null,
"download_count": 1,
"embeddable_by": "all",
"genre": "Electronic",
"is_commentable": true,
"is_downloadable": false,
"is_explicit": null,
"is_music": true,
"is_streamable": true,
"isrc": "TCABG1298306",
"label_name": null,
"last_modified_at": "2022-04-25T07:14:56Z",
"license": "all-rights-reserved",
"monetization_model": "AD_SUPPORTED",
"p_line": null,
"permalink": "lux-aeterna",
"policy": "MONETIZE",
"publisher": "Eric Wahlforss",
"purchase_title": "Get The App",
"purchase_url": "http://itunes.com/app/ecclesia",
"release_title": null,
"released_at": "2012-06-12T00:00:00Z",
"tags": [],
"transcodings": [
{
"duration_ms": 370201,
"is_snipped": false,
"mime_type": "audio/mp4; codecs=\"mp4a.40.2\"",
"preset": "aac_160k",
"protocol": "hls",
"quality": "sq"
},
{
"duration_ms": 370201,
"is_snipped": false,
"mime_type": "audio/mp4; codecs=\"mp4a.40.2\"",
"preset": "aac_96k",
"protocol": "hls",
"quality": "lq"
},
{
"duration_ms": 370201,
"is_snipped": false,
"mime_type": "audio/mpegurl",
"preset": "abr_sq",
"protocol": "hls",
"quality": "sq"
}
],
"upc": null,
"uploaded_at": "2012-06-12T11:29:55Z",
"visual_url": null,
"waveform_url": "https://wave.sndcdn.com/RhJ436DPf2Vx_m.json",
"writer_composer": "Eric Wahlforss"
}
},
"platform_type": "track",
"published_at": "2012-06-12T11:29:55Z",
"text": "Tenth piece from the Ecclesia project.\r\n\r\nProduction: Eric Wahlforss\r\nMixing: Mark Bihler\r\nMastering: Bo Kondren",
"thumbnail_url": "https://i1.sndcdn.com/artworks-000024916496-q9opo6-t500x500.jpg",
"title": "Lux Aeterna",
"type": "audio",
"unknown_fields": [],
"url": "https://soundcloud.com/forss/lux-aeterna"
},
{
"approximate_fields": [],
"author": {
"avatar_url": "https://i1.sndcdn.com/avatars-000012778523-59quu3-t500x500.jpg",
"display_name": "Forss",
"id": "183",
"is_verified": true,
"url": "https://soundcloud.com/forss",
"username": "forss"
},
"coauthors": [],
"duration_ms": 68127,
"hashtags": [],
"id": "49437906",
"is_nsfw": null,
"is_pinned": null,
"is_sponsored": null,
"language": null,
"media": [
{
"alt_text": null,
"duration_ms": 68095,
"expires_at": null,
"height": null,
"thumbnail_url": "https://i1.sndcdn.com/artworks-000024916399-ov6bex-t500x500.jpg",
"type": "audio",
"url": null,
"width": null
}
],
"mentions": [],
"metrics": {
"comment_count": 79,
"like_count": 491,
"quote_count": null,
"repost_count": 89,
"save_count": null,
"share_count": null,
"view_count": 50349
},
"platform": "soundcloud",
"platform_specific": {
"soundcloud": {
"album_title": null,
"artist_name": "Forss",
"author_follower_count": 132108,
"c_line": null,
"caption": null,
"download_count": 0,
"embeddable_by": "all",
"genre": "Electronic",
"is_commentable": true,
"is_downloadable": false,
"is_explicit": null,
"is_music": true,
"is_streamable": true,
"isrc": "TCABG1298305",
"label_name": null,
"last_modified_at": "2019-07-29T16:43:49Z",
"license": "all-rights-reserved",
"monetization_model": "AD_SUPPORTED",
"p_line": null,
"permalink": "veniam",
"policy": "MONETIZE",
"publisher": "Eric Wahlforss",
"purchase_title": "Get The App",
"purchase_url": "http://itunes.com/app/ecclesia",
"release_title": null,
"released_at": "2012-06-12T00:00:00Z",
"tags": [],
"transcodings": [
{
"duration_ms": 68095,
"is_snipped": false,
"mime_type": "audio/mp4; codecs=\"mp4a.40.2\"",
"preset": "aac_160k",
"protocol": "hls",
"quality": "sq"
},
{
"duration_ms": 68095,
"is_snipped": false,
"mime_type": "audio/mp4; codecs=\"mp4a.40.2\"",
"preset": "aac_96k",
"protocol": "hls",
"quality": "lq"
},
{
"duration_ms": 68095,
"is_snipped": false,
"mime_type": "audio/mpegurl",
"preset": "abr_sq",
"protocol": "hls",
"quality": "sq"
}
],
"upc": null,
"uploaded_at": "2012-06-12T11:26:04Z",
"visual_url": null,
"waveform_url": "https://wave.sndcdn.com/DWpqP6aFqglm_m.json",
"writer_composer": "Eric Wahlforss"
}
},
"platform_type": "track",
"published_at": "2012-06-12T11:26:04Z",
"text": "Ninth piece from the Ecclesia project.\r\n\r\nProduction: Eric Wahlforss\r\nMixing: Mark Bihler\r\nMastering: Bo Kondren",
"thumbnail_url": "https://i1.sndcdn.com/artworks-000024916399-ov6bex-t500x500.jpg",
"title": "Veniam",
"type": "audio",
"unknown_fields": [],
"url": "https://soundcloud.com/forss/veniam"
},
{
"approximate_fields": [],
"author": {
"avatar_url": "https://i1.sndcdn.com/avatars-000012778523-59quu3-t500x500.jpg",
"display_name": "Forss",
"id": "183",
"is_verified": true,
"url": "https://soundcloud.com/forss",
"username": "forss"
},
"coauthors": [],
"duration_ms": 326183,
"hashtags": [],
"id": "48031525",
"is_nsfw": null,
"is_pinned": null,
"is_sponsored": null,
"language": null,
"media": [
{
"alt_text": null,
"duration_ms": 326054,
"expires_at": null,
"height": null,
"thumbnail_url": "https://i1.sndcdn.com/artworks-000024190525-pv7oaf-t500x500.jpg",
"type": "audio",
"url": null,
"width": null
}
],
"mentions": [],
"metrics": {
"comment_count": 115,
"like_count": 1156,
"quote_count": null,
"repost_count": 173,
"save_count": null,
"share_count": null,
"view_count": 61203
},
"platform": "soundcloud",
"platform_specific": {
"soundcloud": {
"album_title": null,
"artist_name": "Forss",
"author_follower_count": 132108,
"c_line": null,
"caption": null,
"download_count": 0,
"embeddable_by": "all",
"genre": "Electronic",
"is_commentable": true,
"is_downloadable": false,
"is_explicit": null,
"is_music": true,
"is_streamable": true,
"isrc": "TCABG1298304",
"label_name": null,
"last_modified_at": "2021-06-28T10:35:35Z",
"license": "all-rights-reserved",
"monetization_model": "AD_SUPPORTED",
"p_line": null,
"permalink": "somnio-somnium",
"policy": "MONETIZE",
"publisher": "Eric Wahlforss",
"purchase_title": "Get The App",
"purchase_url": "http://itunes.com/app/ecclesia",
"release_title": null,
"released_at": null,
"tags": [],
"transcodings": [
{
"duration_ms": 326054,
"is_snipped": false,
"mime_type": "audio/mp4; codecs=\"mp4a.40.2\"",
"preset": "aac_160k",
"protocol": "hls",
"quality": "sq"
},
{
"duration_ms": 326054,
"is_snipped": false,
"mime_type": "audio/mp4; codecs=\"mp4a.40.2\"",
"preset": "aac_96k",
"protocol": "hls",
"quality": "lq"
},
{
"duration_ms": 326054,
"is_snipped": false,
"mime_type": "audio/mpegurl",
"preset": "abr_sq",
"protocol": "hls",
"quality": "sq"
}
],
"upc": null,
"uploaded_at": "2012-05-30T08:13:11Z",
"visual_url": null,
"waveform_url": "https://wave.sndcdn.com/sDWnMpZaIQ9Z_m.json",
"writer_composer": "Eric Wahlforss"
}
},
"platform_type": "track",
"published_at": "2012-05-30T08:13:11Z",
"text": "Eighth piece from the Ecclesia project.\r\n\r\nProduction: Eric Wahlforss \r\nMixing: Mark Bihler \r\nMastering: Bo Kondren\r\n\r\nContains a sample from Eric Whitacre's 'Sleep My Child SATB version' https://soundcloud.com/ericwhitacre/sleep-my-child-satb-a-cappella",
"thumbnail_url": "https://i1.sndcdn.com/artworks-000024190525-pv7oaf-t500x500.jpg",
"title": "Somnio Somnium",
"type": "audio",
"unknown_fields": [],
"url": "https://soundcloud.com/forss/somnio-somnium"
}
],
"page": {
"has_more": true,
"next_cursor": "c1.EXAMPLE_CURSOR",
"next_cursor_expires_at": "2026-10-26T12:00:00Z",
"end_reason": null
},
"meta": {
"request_id": "req_3f9c2a7d1e8b4c6a9f0e2d4b6a8c0e1f",
"platform": "soundcloud",
"source": "api",
"is_cached": false,
"credits_charged": 1,
"latency_ms": 518,
"fetched_at": "2026-10-25T12:00:00Z",
"input": {
"kind": "profile",
"id": "183",
"url": "https://soundcloud.com/forss"
},
"credits_remaining": 9999,
"client_request_id": null,
"warnings": []
}
}import { SocialTap } from "socialtap";
const client = new SocialTap(); // apiKey defaults to process.env.SOCIALTAP_API_KEY
const res = await client.soundcloud.tracks.list({ handle: "forss" });
console.log(res.data);
console.log(res.credits.charged, res.meta.request_id);import java.net.URI;
import java.net.URLEncoder;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.nio.charset.StandardCharsets;
public class Main {
public static void main(String[] args) throws Exception {
String query = "handle=" + encode("forss");
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://socialtap.dev/v1/soundcloud/tracks?" + query))
.header("x-api-key", System.getenv("SOCIALTAP_API_KEY"))
.GET()
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
// An error is {"error": {"code", "message", ...}}; success is {data, meta}, meta.credits_charged its price.
if (response.statusCode() >= 400) throw new RuntimeException(response.body());
System.out.println(response.body());
}
static String encode(String value) {
return URLEncoder.encode(value, StandardCharsets.UTF_8);
}
}using System.Text.Json;
using var http = new HttpClient();
http.DefaultRequestHeaders.Add("x-api-key", Environment.GetEnvironmentVariable("SOCIALTAP_API_KEY"));
var query = string.Join("&",
"handle=" + Uri.EscapeDataString("forss"));
var res = await http.GetAsync("https://socialtap.dev/v1/soundcloud/tracks?" + query);
using var body = JsonDocument.Parse(await res.Content.ReadAsStringAsync());
if (!res.IsSuccessStatusCode)
{
var error = body.RootElement.GetProperty("error");
throw new Exception($"{error.GetProperty("code")}: {error.GetProperty("message")}");
}
Console.WriteLine(body.RootElement.GetProperty("data"));
Console.WriteLine(body.RootElement.GetProperty("meta").GetProperty("credits_charged"));// Cargo.toml: reqwest = { version = "0.12", features = ["blocking", "json"] }, serde_json = "1"
use std::env;
fn main() -> Result<(), Box<dyn std::error::Error>> {
let res = reqwest::blocking::Client::new()
.get("https://socialtap.dev/v1/soundcloud/tracks")
.query(&[("handle", "forss")])
.header("x-api-key", env::var("SOCIALTAP_API_KEY")?)
.send()?;
let ok = res.status().is_success();
let body: serde_json::Value = res.json()?;
if !ok {
return Err(format!("{}: {}", body["error"]["code"], body["error"]["message"]).into());
}
println!("{} {}", body["data"], body["meta"]["credits_charged"]);
Ok(())
}200 OK · GET https://socialtap.dev/v1/soundcloud/tracksLong arrays and strings are shortened here. Real responses are complete.Docs One schema on 21 platforms.
The response reference lists every field, its type and when it is null. See the full schema.
Null means unknown
A field SoundCloud doesn't show is null, never zero or an empty string, so a real zero always means zero.
What it accepts
The SoundCloud account: its name (forss, also written @forss), its link (soundcloud.com/forss, with any tab such as /tracks, also on m.soundcloud.com), its numeric ID (183), URN (soundcloud:users:183) or address on the API (api.soundcloud.com/users/183).
Write one parser
SoundCloud, TikTok, Instagram and 18 more platforms answer in these fields, so the code that reads one reads them all.
platformstring- Platform ID (tiktok, youtube, …).
idstring- Platform-native post ID (string; Instagram shortcode, Reddit with its t3_ prefix).
urlstring- Canonical post URL.
typestring- Normalized content shape. New values may be added; treat unknown values as other.
platform_typestring- The platform's own product label, lowercase (reel, short, story, live, tweet, …).
titlestring- Headline (YouTube title, Reddit title); null on caption-only platforms.
textstring- Caption, description or body as plain text.
languagestring- BCP-47 language of text, when the platform states it.
Live data from 33 platforms.
What teams build with the SoundCloud Artist Tracks API.
Export an artist's whole catalog
Monitor an account for new tracks
Compare plays across an artist's releases
Collect ISRCs across an artist roster
Good to know before you build.
- Each track is the same post the SoundCloud Track API returns, with plays in metrics.view_count and reposts in metrics.repost_count. Reposts of other people's tracks aren't in the list.
- A page can hold fewer tracks than limit, and rarely none, while has_more is true, because SoundCloud's list holds rows it hides from logged-out listeners. Only has_more false ends the list.
- Newest first is by published_at, the date SoundCloud shows, which a scheduled or back-dated release sets apart from platform_specific.soundcloud.uploaded_at. Tracks with the same published_at come by ID, highest first.
- platform_specific.soundcloud.policy, monetization_model and transcodings and media[].duration_ms are what SoundCloud serves a logged-out listener in the United States, wherever you call from, and can differ in other countries. Under policy BLOCK nothing plays and media[].duration_ms is null.
- media[].url is null, because SoundCloud's playback links need a request of their own per track and expire within minutes. platform_specific.soundcloud.transcodings lists the encodings it serves.
- A share link (on.soundcloud.com/…) is read as a track's link by the SoundCloud Track API only, and the embedded player's link is refused: send the account's link, name or ID.
1 credit per page. Failed requests are free.
Buy credits once and spend them on any endpoint, on any platform.
| Source | Price per successful page | Per 1,000 pages |
|---|---|---|
Platform API api | 1 credit | $0.75–$1.97 |
Public page page | 1 credit | $0.75–$1.97 |
- Cache hits are free.
- Credits from packs and top-ups never expire.
- A monthly plan's credits are spent first, and what is left of them ends at each renewal.
- Prices exclude tax: sales tax is added at checkout where it applies.
- Outside the US, plans and packs are sold to businesses: checkout asks for your VAT, GST or other business tax ID.
Questions about the SoundCloud Artist Tracks API.
More in the API reference.
Can I get only the tracks since a date?
How much does the SoundCloud Artist Tracks API cost?
How do I get the next page?
Try it on an account you know.
Paste its handle or link in the playground, or copy the request into your code.
- No credit card
- Failed requests are free
- Works on all 218 endpoints