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 Failed requests are free

About this endpoint

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.

Bill from meta.creditsCharged. 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. See the API docs for parameters and examples.

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.