tiktok/app-v3/music-search-result
Get music search results of specified keywords.
Input
Number, do not exceed 20
Filter type, 0-All, 1-Title, 2-Author, default is 0-All
Keyword
Offset, starting from 0, the second page gets the cursor value from the response as the offset to continue the request.
Region, default is US-America, for optional values please refer to TikTok region codes or ISO 3166-1 alpha-2 country codes.
Sort type, 0-Relatedness, 1-Most used, 2-Latest, 3-Shortest duration, 4-Longest duration, default is 0-Relatedness
Idle
Example output — click Run to generate your own
Production endpoint
Send your first request
OpenAI-compatible endpoint with unified authentication and usage tracking.
POST
https://api.sandbase.ai/v1/runModel ID
tiktok/app-v3/music-search-result01
Input Schema
6 parameters · 1 required · 5 optional
| Parameter | Type | Required | Description |
|---|---|---|---|
keyword | string | Required | Keyword |
count | integer | Optional | Number, do not exceed 20 · Default: 20 |
offset | integer | Optional | Offset, starting from 0, the second page gets the cursor value from the response as the offset to continue the request. · Default: 0 |
region | string | Optional | Region, default is US-America, for optional values please refer to TikTok region codes or ISO 3166-1 alpha-2 country codes. · Default: "US" |
filter_by | integer | Optional | Filter type, 0-All, 1-Title, 2-Author, default is 0-All · Default: 0 |
sort_type | integer | Optional | Sort type, 0-Relatedness, 1-Most used, 2-Latest, 3-Shortest duration, 4-Longest duration, default is 0-Relatedness · Default: 0 |
02
Output Schema
| Field | Type | Description |
|---|---|---|
id | string | Unique identifier for the generation task |
status | string | Task status: pending, running, completed, failed, timeout |
model | string | Model used for the generation |
outputs | array | Array of output items |
outputs[].url | string | URL of the generated artifact |
outputs[].content_type | string | MIME type (e.g. image/png, video/mp4) |
error | object | null | Error details if failed, null on success |
error.type | string | Machine-readable error type code |
error.message | string | Human-readable error description |
03
Code Examples
Ready-to-run snippets
curl -X POST https://api.sandbase.ai/v1/run \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"model": "tiktok/app-v3/music-search-result",
"count": 20,
"offset": 0,
"region": "US",
"filter_by": 0,
"sort_type": 0,
"prompt": "a beautiful sunset over mountains"
}'API README
Get music search results of specified keywords
Get music search results of specified keywords. It is suitable for tiktok workflows.
Capability
Get music search results of specified keywords. It helps applications, agents, and automated workflows turn that capability into repeatable tasks and useful downstream experiences.
Common use cases
- Search and discover relevant records for research, monitoring, and product experiences.
- Create repeatable integrations that pass structured results to downstream business systems.
- Support scheduled jobs, internal tools, and agent workflows with structured results.