Skip to main content
GET
Search Music
💳 1 credit per request — returns 10 results. Use offset to paginate.

Authorizations

X-API-Key
string
header
required

API key for authentication. Format: sk_live_xxxxxxxxxxxxx

Get your API key from the Dashboard.

Query Parameters

keyword
string
required

Search query text

Example:

"nike"

region
string

Alpha-2 country code (default: US)

Example:

"GB"

filter_by
enum<string>

Filter type: 0 - All, 1 - Title, 2 - Creators

Available options:
0,
1,
2
sort_type
enum<string>

Sort type: 0 - Relevance, 1 - Most used, 2 - Most recent, 3 - Shortest, 4 - Longest

Available options:
0,
1,
2,
3,
4
offset
integer

Pagination offset. If the response has has_more: 1, use the cursor value from the response as the offset for the next page.

Example:

0

Response

Successful response

Key Response Fields:

  • data.music[].id_str: Unique music ID (use this instead of id to avoid precision issues)
  • data.music[].title: Song title
  • data.music[].author: Artist/creator name
  • data.music[].album: Album name
  • data.music[].duration: Clip duration in seconds (the usable TikTok clip)
  • data.music[].play_url.url_list[0]: Direct audio playback URL
  • data.music[].cover_large.url_list[0]: High-res cover art (720x720)
  • data.music[].cover_medium.url_list[0]: Medium cover art (100x100)
  • data.music[].artists[]: Artist details including nick_name, handle, sec_uid, and avatar
  • data.music[].artists[].is_verified: Whether the artist is verified
  • data.music[].matched_song: Original full song info including full_duration (in ms)
  • data.music[].language: Detected language of the track
  • data.music[].theme_tags: Tags like "Party", "Chill", etc.
  • data.music[].has_human_voice: Whether the track contains vocals
  • data.music[].is_commerce_music: Whether cleared for commercial use
  • data.music[].is_original_sound: Whether it's an original TikTok sound vs. licensed music
  • data.music[].video_duration: Max video duration allowed with this sound
  • data.music[].search_music_name: Display name shown in search results
  • data.music[].search_music_desc: Display description shown in search results
  • data.music[].tt_to_dsp_song_infos[]: Links to streaming platforms (Apple Music, Spotify, etc.)
  • data.has_more: 1 if more results available, 0 if not
  • data.cursor: Pass as offset parameter to get next page
  • data.total: Total number of matching results
  • data.music_info_list[]: Alternative format of results with card_type metadata