Docs · Song
Song
A TikTok sound: title, artist, album, length, cover, audio URL and how many videos use it.
https://api.lurkapi.com/v1/tiktok/songWhen to use this
Use it to size up a sound before you build content on it: videoCount is how many posts use it. original: true means a creator's original sound rather than a released track, and is_commerce_music is TikTok's flag for sounds cleared for commercial use (the ones business accounts can pick). Get the id from any video's music.id, or pass the sound's tiktok.com/music/… URL.
Unknown and removed sounds return 404 not_found.
Parameters
All parameters go in the query string.
| Parameter | Description |
|---|---|
clipIdstringrequired | The sound's id, e.g. 7433619007506761744, or its URL (https://www.tiktok.com/music/…-<id>). Every video carries it as music.id.
|
Example request
Replace YOUR_API_KEY with your key, or set LURKAPI_KEY for the code. Get a free key.
curl "https://api.lurkapi.com/v1/tiktok/song?clipId=7433619007506761744" \
-H "x-api-key: YOUR_API_KEY"const params = new URLSearchParams({
clipId: "7433619007506761744",
});
const res = await fetch(`https://api.lurkapi.com/v1/tiktok/song?${params}`, {
headers: { "x-api-key": process.env.LURKAPI_KEY },
});
const data = await res.json();
if (!data.success) throw new Error(`${data.code}: ${data.error}`);
console.log(data);import os
import requests
res = requests.get(
"https://api.lurkapi.com/v1/tiktok/song",
params={
"clipId": "7433619007506761744",
},
headers={"x-api-key": os.environ["LURKAPI_KEY"]},
timeout=60,
)
data = res.json()
if not data["success"]:
raise RuntimeError(f"{data['code']}: {data['error']}")
print(data)Example response
A real response from this endpoint, captured from the live API and trimmed to a couple of items. Strings over 96 characters (mostly signed media URLs) are cut short and end in ….
Show the example response (1 KB)Hide
{
"success": true,
"credits_remaining": 99955,
"credits_charged": 1,
"id": "7433619007506761744",
"url": "https://www.tiktok.com/music/Morning-Brew-Jazz-7433619007506761744",
"title": "Morning Brew Jazz",
"authorName": "NonLeo",
"album": "Morning Brew Jazz",
"original": false,
"duration": 265,
"cover": "https://p16-common.tiktokcdn-us.com/tos-alisg-v-2774/oAJSAyArAD0EpAPixgA…",
"playUrl": "https://sf16.tiktokcdn-us.com/obj/tos-alisg-ve-2774/ocKlBfzUWiBoMThA1QzwiAapIOsMBFDSsAAEcS",
"videoCount": 31300,
"isCopyrighted": false,
"is_commerce_music": true,
"author": null
}Response fields
Every field of a successful response. [] marks a list: a[].b is the b of each item in a. nullable fields can be null; optional fields can be missing.
Show all 21 fieldsHide
| Field | Type | Description |
|---|---|---|
| success | true | Always true here; errors have success: false. |
| credits_remaining | number | Your balance after this call. On anonymous playground calls: free tries left today. |
| credits_charged | number | Credits this call cost; 0 on free endpoints. On anonymous playground calls: tries used (1). |
| id | string | Sound id. |
| url | string | The sound's page on tiktok.com. |
| title | string | Sound title, e.g. original sound or the track name. |
| authorName | stringnullable | Artist, or the creator's display name for original sounds. |
| album | stringnullable | Album of a released track; null for original sounds and when TikTok doesn't say. |
| original | boolean | An original sound a creator made, rather than a released track. |
| duration | numbernullable | Length in seconds (for tracks, the clip TikTok offers); null if unknown. |
| cover | stringnullable | Cover art URL (may expire after a few days); null if TikTok has none. |
| playUrl | stringnullable | Audio URL (may expire after a few hours); null if TikTok has none. |
| videoCount | number | Posts using this sound. |
| isCopyrighted | boolean | TikTok marks the sound as copyrighted. |
| is_commerce_music | boolean | TikTok's commercial-use flag: cleared for business accounts and ads. |
| author | objectnullable | The TikTok account behind the sound: its creator for original sounds, the artist's account for tracks; null if none. |
| author.id | string | Numeric user id. |
| author.uniqueId | string | Username (handle), without @. |
| author.nickname | string | Display name. |
| author.secUid | string | TikTok's long, stable user id. |
| author.avatarThumb | stringnullable | Small avatar URL (expires after a few days); null if TikTok has none. |
Caching and freshness
Responses are cached for up to 1 hour, so a repeat call within that window can return the same data. It still costs 1 credit.
Errors
Errors return { success: false, error, code, docs } with the HTTP status below. Validation errors, 401/402/429 rejections and 5xx failures are free; not_found is charged (how charging works). All error codes.
| Status | Code | Meaning |
|---|---|---|
| 401 | missing_api_key | No API key. Send it in the x-api-key header. |
| 401 | invalid_api_key | The key is unknown or was revoked. |
| 402 | insufficient_credits | Not enough credits for this call. Buy a pack or wait for tomorrow's top-up. |
| 404 | not_found | The endpoint, or the thing you asked for (ad, post, subreddit), doesn't exist. Charged when the platform was checked. |
| 405 | method_not_allowed | Endpoints take GET with query params. |
| 429 | rate_limited | Too many calls at once. Wait for the retry-after seconds, then retry. |
| 500 | internal_error | Something broke on our side. Retry; 5xx errors are free. |
| 502 | upstream_error | The platform didn't give a usable answer. Retry; 5xx errors are free. |
| 503 | upstream_busy | All our connections to the platform are busy. Retry in a few seconds; 5xx errors are free. |
| 504 | upstream_timeout | The platform took over 30 seconds to answer. Retry; timeouts are free. |
Use it in Claude
Once LurkAPI is connected to Claude, this endpoint is the tiktok_song tool. Ask in plain English, for example:
Use LurkAPI's tiktok_song with clipId "7433619007506761744" and summarize what you find.Claude calls tiktok_song with arguments like these, and each call costs 1 credit:
{
"clipId": "7433619007506761744"
}Tool results skip nulls and empty lists to save tokens.