tiktok

Search Music

Search TikTok sounds and music by keyword. Returns 10 results per page — use the offset parameter with the cursor value from the previous response to load more.

get/v1/scrape/tiktok/search/music

Request

  • Base URL: https://api.sociavault.com
  • URL: https://api.sociavault.com/v1/scrape/tiktok/search/music
  • Auth: API key in header X-API-Key

Query parameters

keywordstring required
Example:nike

Search query text

regionstring
Example:GB

Alpha-2 country code (default: US)

filter_by'0' | '1' | '2'

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

sort_type'0' | '1' | '2' | '3' | '4'

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

offsetinteger

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

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

Changes

No recorded changes to this operation across all 1 revision of this API.