tiktok_search_keyword
Search TikTok videos by keyword phrase and retrieve paginated results from keyword pages for content research or trend analysis.
Instructions
tiktok: Search by Keyword (keyword pages). GET /v1/tiktok/search/keyword. Get TikTok videos for a phrase from TikTok's public keyword page for it (tiktok.com/discover/), 16 per page, as search_item_list of aweme_info objects (aweme_id, desc, create_time, author, statistics, video, music). The phrase is turned into the page's slug ("how to tie a tie" → how-to-tie-a-tie). Videos only: no accounts, hashtags or sounds. This covers only phrases TikTok has a keyword page for: most multi- Costs 1 credit when it succeeds. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"query": "<query>"
},
"name": "tiktok_search_keyword"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| trim | No | Set to true to get a trimmed response | |
| query | Yes | The phrase to look up, as words (how to tie a tie) or as the keyword page's slug (how-to-tie-a-tie) | |
| cursor | No | The cursor string from the previous page's response ("<offset>:<session id>", such as 16:2026111707043796BD7F5020338800F556). It keeps later pages from repeating earlier ones; any other value returns 400 | |
| region | No | Accepted for compatibility but ignored: results are read as a US visitor | |
| sort_by | No | Accepted for compatibility but ignored: results keep the keyword page's order | |
| date_posted | No | Accepted for compatibility but ignored: keyword pages cannot be filtered by date |