tiktok_shop_search
TikTok Shop keyword search — priced products with rating/reviews, typed discount, seller id. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
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": {
"q": "<q>"
},
"name": "tiktok_shop_search"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | Yes | Product search query (min 2 characters), e.g. phone case. | |
| sort | No | Order of the returned page: relevance (default, search order), price_asc, price_desc, rating, reviews, discount. Sorts only the products in this response, not TikTok's whole catalog. Products without the value come last. | |
| cache | No | Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. | |
| limit | No | Max items to return (default 10, max 10). Flat 2 credits per call. | |
| cursor | No | Leave empty for the first page; then pass nextCursor from the previous response (e.g. 10). Each page is a separate call at the same price. | |
| fields | No | Optional comma-separated keys to keep on each result row (or on the object for single-item tools), e.g. id,url,publishedAt,engagement. Pagination keys are always kept. Does not change the price. | |
| region | No | Two-letter market region for the search (default US). Echoed on the response as data.region — not a creator home country. Native search is a SERP window (not TikTok's full catalog); compare requested to serpHits / windowMax. | |
| compact | No | Default true here: drop signed media URLs (video, image, avatar links and their expiry stamps) to keep the response small. Ids, permalinks, dates, text and metrics stay. On Threads, Facebook, Meta Ad Library and TikTok Shop tools request timings are dropped too. Pass false for the full body. |