Social Fetch
Get API key
TikTok hub

TikTok Song API

Look up a public TikTok song or sound by id and get title, author, audio and cover URLs, duration, and usage count in the shared Social Fetch envelope.

GET /v1/tiktok/songs

1 credit per successful request.

Try in playgroundFull API docs

About this endpoint

Sound pages are how TikTok tracks travel between creators. Trend reports, rights checks, and creator tools often start with a music id from a video response or the trailing digits on a music URL, not a free-text search.

`GET /v1/tiktok/songs` takes a required `id` query param (TikTok song or sound id). Use the trailing id from a music page URL, or `music.id` from a `GET /v1/tiktok/videos` lookup. On a found response you get `data.song` with `id`, `title`, `author`, optional `album`, `playUrl`, `coverUrl`, `durationSec`, `videoCount`, `isOriginal`, `isArtist`, and `shareUrl`. Branch on `data.lookupStatus` (`found` / `not_found`) before you write rows — HTTP 200 alone does not mean the sound resolved.

Pricing is on the credit badge for this operation; bill from `meta.creditsCharged` on every response. This route is single-sound metadata. To page videos that use a clip, use `GET /v1/tiktok/music/{clipId}/videos` on the same TikTok hub and API key.

TikTok Song API FAQ

How do I get TikTok song or sound details via API?

Call `GET /v1/tiktok/songs` with your Social Fetch API key (`x-api-key`) and a song or sound `id` query param. Read `data.lookupStatus`, then `data.song`. Full parameters and examples are in the API docs.

How much does the TikTok Song API cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged — that field is the billing source of truth.

Where do I get the TikTok song id?

Take the trailing id from a public TikTok music page URL, or read `music.id` from a video lookup on `GET /v1/tiktok/videos`. Pass that value as the `id` query param on this route.

What does the TikTok song response include?

When found: `data.song` with `id`, `title`, `author`, optional `album`, `playUrl`, `coverUrl`, `durationSec`, `videoCount`, `isOriginal`, `isArtist`, and `shareUrl`. Always branch on `data.lookupStatus` first.

Does a completed lookup always mean the song was found?

No. HTTP 200 means the request finished. Check `data.lookupStatus`: `found` means you got song details; `not_found` means the id did not resolve. Persist `meta.requestId` when you need to debug a miss.

TikTok song vs music videos list?

This route returns metadata for one sound by id. `GET /v1/tiktok/music/{clipId}/videos` pages public videos that use a clip. Resolve the sound here first, then list usage when you need the video set.

Do I need TikTok OAuth to look up a song?

No. You authenticate to Social Fetch with an API key. The route reads public sound data; it does not act on behalf of a logged-in TikTok user.

Other TikTok endpoints