TikTok Sound Search API. Sounds and songs matching your search.
Sounds and songs by title, artist or keyword. We handle the proxies, blocks and platform changes.
TikTok Sound Search API at a glance
Returns the TikTok sounds a web search finds for a song title, artist or keyword, each with its link, a page at a time. Its title, artist or creator and video count come too, as the search index shows them. Add fill=true to also get each sound's full live record (sound ID, duration, cover art, audio link, album, exact video count) in the same response.
GET /v1/tiktok/search_sounds
- 1 credit per page, +1 per result filled in, up to 51 credits, $0.75–$1.97 per 1,000 pages
- 16 typed fields null when unknown
- 50 sounds and songs per page, the search engine's ranking (most relevant first)
queryis all it needs, e.g.taylor swift
Send one request. Get up to 50 sounds and songs 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 socialtapquery = taylor swiftconst params = new URLSearchParams({
query: "Taylor Swift",
});
const res = await fetch(`https://socialtap.dev/v1/tiktok/search_sounds?${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/tiktok/search_sounds",
params={"query": "Taylor Swift"},
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/tiktok/search_sounds")
uri.query = URI.encode_www_form('query' => 'Taylor Swift')
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([
'query' => 'Taylor Swift',
]);
$ch = curl_init('https://socialtap.dev/v1/tiktok/search_sounds?' . $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("query", "Taylor Swift")
req, err := http.NewRequest("GET", "https://socialtap.dev/v1/tiktok/search_sounds?"+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 -G 'https://socialtap.dev/v1/tiktok/search_sounds' \
--data-urlencode 'query=Taylor Swift' \
-H "x-api-key: $SOCIALTAP_API_KEY"{
"data": [
{
"approximate_fields": [
"sound.metrics.post_count"
],
"community": null,
"details": null,
"hashtag": null,
"matched_url": "https://www.tiktok.com/music/Style-6792322634764781569",
"place": null,
"platform": "tiktok",
"platform_specific": {},
"position": 0,
"post": null,
"profile": null,
"snippet": "Style song created by Taylor Swift. 121.5K videos. Watch the latest videos about Style on TikTok.",
"sound": {
"author_name": "Taylor Swift",
"cover_url": null,
"id": null,
"is_original": null,
"metrics": {
"post_count": 121500
},
"title": "Style",
"url": "https://www.tiktok.com/music/-6792322634764781569"
},
"title": "Taylor Swift - Style | TikTok",
"type": "sound",
"unknown_fields": [],
"url": "https://www.tiktok.com/music/-6792322634764781569"
},
{
"approximate_fields": [
"sound.metrics.post_count"
],
"community": null,
"details": null,
"hashtag": null,
"matched_url": "https://www.tiktok.com/music/Style-Taylor's-Version-7294449191711197186",
"place": null,
"platform": "tiktok",
"platform_specific": {},
"position": 1,
"post": null,
"profile": null,
"snippet": "Style (Taylor's Version) song created by Taylor Swift. 820.1K videos. Watch the latest videos about Style (Taylor's Version) on TikTok.",
"sound": {
"author_name": "Taylor Swift",
"cover_url": null,
"id": null,
"is_original": null,
"metrics": {
"post_count": 820100
},
"title": "Style (Taylor's Version)",
"url": "https://www.tiktok.com/music/-7294449191711197186"
},
"title": "Taylor Swift - Style (Taylor's Version) | TikTok",
"type": "sound",
"unknown_fields": [],
"url": "https://www.tiktok.com/music/-7294449191711197186"
},
{
"approximate_fields": [
"sound.metrics.post_count"
],
"community": null,
"details": null,
"hashtag": null,
"matched_url": "https://www.tiktok.com/music/Ready-For-It-6752003161755486209",
"place": null,
"platform": "tiktok",
"platform_specific": {},
"position": 2,
"post": null,
"profile": null,
"snippet": "...Ready For It? song created by Taylor Swift. 177.3K videos. Watch the latest videos about ...Ready For It? on TikTok.",
"sound": {
"author_name": "Taylor Swift",
"cover_url": null,
"id": null,
"is_original": null,
"metrics": {
"post_count": 177300
},
"title": "...Ready For It?",
"url": "https://www.tiktok.com/music/-6752003161755486209"
},
"title": "Taylor Swift - ...Ready For It? | TikTok",
"type": "sound",
"unknown_fields": [],
"url": "https://www.tiktok.com/music/-6752003161755486209"
}
],
"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": "tiktok",
"source": "web_search",
"is_cached": false,
"credits_charged": 1,
"latency_ms": 1139,
"fetched_at": "2026-10-25T12:00:00Z",
"input": null,
"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.searchSounds.list({ query: "Taylor Swift" });
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 = "query=" + encode("Taylor Swift");
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://socialtap.dev/v1/tiktok/search_sounds?" + 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("&",
"query=" + Uri.EscapeDataString("Taylor Swift"));
var res = await http.GetAsync("https://socialtap.dev/v1/tiktok/search_sounds?" + 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/search_sounds")
.query(&[("query", "Taylor Swift")])
.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/search_soundsLong arrays and strings are shortened here. Real responses are complete.Docs One schema on 6 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
Words to find TikTok sounds by, as a web search reads them: a song, an artist, a mood (taylor swift, lofi, "cruel summer").
Write one parser
TikTok, Instagram, Facebook and 3 more platforms answer in these fields, so the code that reads one reads them all.
platformstring- Platform the item is on.
typestring- The kind of item the result names, as the resource that describes it: profile (an account), post, hashtag, sound, place or community. The item's summary is the field of that name, and a filled result's record is details.<type>. A search that finds several kinds (a platform's top search) mixes them in one list. New values may be added as more kinds are searchable; treat unknown values as other.
positioninteger- Zero-based rank of the result in the list, across pages: the search engine's order, counting only the results kept.
urlstring- The item's canonical link on the platform (the account's page for a profile, the post's for a post).
matched_urlstring- The page the index listed: the item's own page, or one of its pages that names it (a video of an account, for a profile found through it).
titlestring- The page's title as the index shows it: often the item's name, but not the item's own field. Null when the index shows none.
snippetstring- The index's excerpt of the page: often the item's description and counts as the page stated them when it was indexed, days or weeks ago. Null when the index shows none.
profileobject- The account the result names (type profile): what its link and the index's text say of it, completed from details when the result is filled. Null for every other type.
Live data from 33 platforms.
What teams build with the TikTok Sound Search API.
Find a song's TikTok sound by title
Track how many videos use an artist's sounds
Pick audio for a campaign
Find original sounds around a topic
Good to know before you build.
- TikTok's sound search needs a login, so results come from a web search engine's index of TikTok's sound pages, in that engine's ranking, with no sort or filter.
- Without fill, a sound's id, duration, cover and audio link are null, and its title, author and video count are the index's copy of its page: rounded and possibly weeks old (listed in approximate_fields).
- With fill=true each result's details.sound is the sound's live record from the TikTok Sound API, and its summary is updated from it.
- is_original is true when the title or link says original sound, and otherwise null until filled, because the index never says a sound is not original.
- A result the sound lookup couldn't fetch (a removed sound) stays unfilled and costs nothing extra, and meta.warnings says how many.
- The index goes only so deep: a search ends after a few pages (page.end_reason end).
- Case doesn't matter, and site: operators in your query are removed.
From 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 |
|---|---|---|
| Any source | 1 credit + 1 per result filled in up to 51 credits (50 results filled in) | $0.75–$1.97 + $0.75–$1.97 per result filled in |
- 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 Search API.
More in the API reference.
How much does the TikTok Sound Search API cost?
How do I get the next page?
Try it with your own search.
Type it in the playground, or copy the request into your code.
- No credit card
- Failed requests are free
- Works on all 218 endpoints