---
title: "Search Music"
method: GET
path: "/v1/scrape/tiktok/search/music"
tags: ["tiktok"]
---

# Search Music

`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`

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.

## Query parameters

- `keyword` string, required
- `region` string
- `filter_by` '0' | '1' | '2'
- `sort_type` '0' | '1' | '2' | '3' | '4'
- `offset` integer

## Response `200`

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

## Other responses

- `400`: Bad request
- `402`: Insufficient credits

---

[API](https://skmtc.dev/sociavault/apis/sociavault-api.md) · [All operations](https://skmtc.dev/sociavault/apis/sociavault-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sociavault/apis/sociavault-api/revisions/0a430c97f53a?raw)