TikTok Sound API. Send a sound link or ID.
Sound or song with its artists and post count. We handle the proxies, blocks and platform changes.
TikTok Sound API at a glance
Returns a TikTok sound, a catalog track or a creator's original audio, from its link or ID, with its title, artists and how many posts use it. You also get the artists' TikTok accounts, clip length, cover art, an audio file link, album, the track's Spotify and Apple Music pages, and for an original sound the song TikTok matched its audio to.
GET /v1/tiktok/sound
- 1 credit per request, $0.75–$1.97 per 1,000 requests
- 14 typed fields null when unknown
urlis all it needs, e.g.https://www.tiktok.com/music/Different-Acoustic-6717159721276540930- 100 credits free when you sign up, no card, so you can build before you spend
Send one request. Get 14 fields 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 socialtapurl = https://www.tiktok.com/music/Different-Acoustic-6717159721276540930const params = new URLSearchParams({
url: "https://www.tiktok.com/music/Different-Acoustic-6717159721276540930",
});
const res = await fetch(`https://socialtap.dev/v1/tiktok/sound?${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, meta } = body;
console.log(data, meta.credits_charged);import os
import requests
res = requests.get(
"https://socialtap.dev/v1/tiktok/sound",
params={"url": "https://www.tiktok.com/music/Different-Acoustic-6717159721276540930"},
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, meta = body["data"], body["meta"]
print(data, meta["credits_charged"])require "json"
require "net/http"
uri = URI("https://socialtap.dev/v1/tiktok/sound")
uri.query = URI.encode_www_form('url' => 'https://www.tiktok.com/music/Different-Acoustic-6717159721276540930')
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([
'url' => 'https://www.tiktok.com/music/Different-Acoustic-6717159721276540930',
]);
$ch = curl_init('https://socialtap.dev/v1/tiktok/sound?' . $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("url", "https://www.tiktok.com/music/Different-Acoustic-6717159721276540930")
req, err := http.NewRequest("GET", "https://socialtap.dev/v1/tiktok/sound?"+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"`
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 -G 'https://socialtap.dev/v1/tiktok/sound' \
--data-urlencode 'url=https://www.tiktok.com/music/Different-Acoustic-6717159721276540930' \
-H "x-api-key: $SOCIALTAP_API_KEY"{
"data": {
"approximate_fields": [],
"author_name": "Micah Tyler",
"authors": [
{
"avatar_url": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/0c546a533704730017922fba148f4cc9~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=9640&refresh_token=11ca7945&x-expires=4070908800&x-signature=SCRUBBED&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast5",
"display_name": "Micah Tyler",
"id": "7086245766293226538",
"is_verified": null,
"url": "https://www.tiktok.com/@micahtylertok",
"username": "micahtylertok"
}
],
"cover_url": "https://p16-common.tiktokcdn-us.com/tos-alisg-v-2774/okeuMAAZnBBv88JZBjFEgjDOtWCZQ4AEEwfoQb~tplv-tiktokx-cropcenter:720:720.jpeg?dr=9584&t=4d5b0474&ps=933b5bde&shp=08d74b56&shcp=81f88b70&idc=useast5",
"duration_ms": 60000,
"id": "6717159721276540930",
"is_original": false,
"metrics": {
"post_count": 523
},
"platform": "tiktok",
"platform_specific": {
"tiktok": {
"album": "Different",
"is_commercial_music": false,
"matched_song": {
"id": "6717159725093390337",
"streaming_links": [
{
"service": "apple_music",
"url": "https://music.apple.com/song/1545544887"
},
{
"service": "spotify",
"url": "https://open.spotify.com/track/0hxxRQOLZLdbGDl4dgrsPV"
}
]
}
}
},
"play_url": "https://sf19.tiktokcdn-us.com/obj/tos-alisg-ve-2774/oIBIZNfxOX2Nzi1WRH4ABroDirMAuIjwsGVov9",
"streaming_links": [
{
"service": "apple_music",
"url": "https://music.apple.com/song/1545544887"
},
{
"service": "spotify",
"url": "https://open.spotify.com/track/0hxxRQOLZLdbGDl4dgrsPV"
}
],
"title": "Different (Acoustic)",
"unknown_fields": [],
"url": "https://www.tiktok.com/music/-6717159721276540930"
},
"meta": {
"request_id": "req_3f9c2a7d1e8b4c6a9f0e2d4b6a8c0e1f",
"platform": "tiktok",
"source": "api",
"is_cached": false,
"credits_charged": 1,
"latency_ms": 257,
"fetched_at": "2026-10-25T12:00:00Z",
"input": {
"kind": "sound",
"id": "6717159721276540930",
"url": "https://www.tiktok.com/music/-6717159721276540930"
},
"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.tiktok.sound.get({ url: "https://www.tiktok.com/music/Different-Acoustic-6717159721276540930" });
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 = "url=" + encode("https://www.tiktok.com/music/Different-Acoustic-6717159721276540930");
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://socialtap.dev/v1/tiktok/sound?" + 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("&",
"url=" + Uri.EscapeDataString("https://www.tiktok.com/music/Different-Acoustic-6717159721276540930"));
var res = await http.GetAsync("https://socialtap.dev/v1/tiktok/sound?" + 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/tiktok/sound")
.query(&[("url", "https://www.tiktok.com/music/Different-Acoustic-6717159721276540930")])
.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/tiktok/soundDocs One schema on 2 platforms.
The response reference lists every field, its type and when it is null. See the full schema.
Null means unknown
A field TikTok doesn't show is null, never zero or an empty string, so a real zero always means zero.
What it accepts
A TikTok sound link (the sound page's tiktok.com/music/Different-Acoustic-6717159721276540930, or a share page's tiktok.com/share/music/6717159721276540930) or the sound's numeric ID (the clip ID at the end of that link, the music.id of a post).
Write one parser
TikTok and Instagram answer in these fields, so the code that reads one reads them all.
platformstring- Platform ID (tiktok, instagram, …).
idstring- Platform-native sound ID (string), the one in its page's URL; equals the ID a post's sound reference carries.
urlstring- Canonical page of the sound, listing the posts that use it; null where the platform has none (Facebook).
titlestring- Sound or track title as shown (an original sound's generated title, e.g. "original sound - <name>", included).
author_namestring- Who the platform credits for the sound: a track's artist(s) as one display string, or the creator's name for an original sound.
authorsobject[]- The platform accounts behind author_name (a track's artists, or the creator of an original sound), in the platform's order; [] when none is linked.
is_originalboolean- An original sound a creator uploaded or recorded (false: a catalogue or licensed track).
duration_msinteger- Length of the audio the platform serves for the sound, in milliseconds (TikTok: the usable clip, often shorter than the full song).
Live data from 33 platforms.
What teams build with the TikTok Sound API.
Find the song behind a trending sound
Track how many videos use a sound
Get a track's Spotify and Apple Music links
Group original sounds by their matched song
Good to know before you build.
- TikTok rounds large post counts, and approximate_fields lists them.
- duration_ms is the clip TikTok serves for the sound, often shorter than the full song.
- play_url and cover_url are TikTok CDN links that expire.
- An original sound's streaming_links are []: the song TikTok matched its audio to is platform_specific.tiktok.matched_song, with its ID and streaming pages (its title isn't served logged out).
- is_commercial_music is TikTok's own is_commerce_music flag, not a license check: TikTok sets it on original sounds and leaves it false on many licensed tracks.
- If TikTok's sound detail is down, the answer comes from the sound's embed page with only its artist credit, cover and post count; the other fields are null, and authors and streaming_links are listed in unknown_fields.
1 credit per request. Failed requests are free.
Buy credits once and spend them on any endpoint, on any platform.
| Source | Price per successful request | Per 1,000 requests |
|---|---|---|
| Any source | 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 TikTok Sound API.
More in the API reference.
How much does the TikTok Sound API cost?
A request costs 1 credit. SocialTap credits cost $0.75–$1.97 per 1,000, depending on the plan or pack.
Try it on a link you already have.
Paste it in the playground, or copy the request into your code.
100free credits
- No credit card
- Failed requests are free
- Works on all 218 endpoints