TikTok Search Music
Search for music that matches a keyword. The keyword is required. Optional parameters are offset (default 0; use the cursor from a previous response as the next offset when available), count (default 20; do not exceed 20), filter_by (0 = all, 1 = title, 2 = author; default 0), sort_type (0 = relevance, 1 = most used, 2 = newest, 3 = shortest duration, 4 = longest duration; default 0), and region (default US; provide a supported region code). The response contains the music search results in its data field, along with response metadata when available.
Pricing
| Condition | Charge |
|---|---|
| Each call | 2.07 credits/call |
2.07 credits/call Charges are per query. A successful query is billed even if it returns no results.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
count | integer | No | 数量/Number | 20 |
offset | integer | No | 偏移量/Offset | 0 |
region | string | No | 地区/Region | US |
keyword | string | Yes | 关键词/Keyword | — |
filter_by | integer | No | 过滤类型/Filter type | 0 |
sort_type | integer | No | 排序类型/Sort type | 0 |
Invocation example
Parameter templateGenerated from the parameter configuration. Replace the sample values before use.
/agent-api/v1/tool/executeX-Api-Keycurl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_tiktok_search_music' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"keyword": "xxx"
}
}'No response example available yet.

