Search LIVE now
live_searchFinds TikTok LIVE broadcasts on now by keyword, with viewers and whether the room sells Shop products. Pass a room id to live. Not a sales ranking (use live_top_selling). Example: {"keyword":"skincare"}.
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": {
"keyword": "<keyword>"
},
"name": "live_search"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Results per page. Max 30. Values above a method's maximum are lowered and reported in notes. | |
| cursor | No | Paging: pass the next value from the previous response unchanged. Omit on the first page. | |
| detail | No | compact (default) returns the useful fields; full adds the full raw record (large). | compact |
| region | No | Market as an ISO country code, default US. Shop Analytics methods: sales data for that market, amounts in its currency. Live methods that take it (search, video detail, creator posts, Shop pages): TikTok as seen in that market where TikTok serves it. Core: US, GB, DE, FR, ES, JP, TH, VN, ID, MY, PH, BR, MX. Extended: PL, IT, NL, IE. Other countries are refused. See shop_regions. | |
| keyword | Yes | Search phrase, e.g. 'lip oil'. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||