TikTok Shop Fetch Search Word Suggestion V2
2.07 credits/call
ae_tiktok_shop_fetch_search_word_suggestion_v2
Fetch suggested product-search terms for a required search_word. Optionally set lang (default: en-US) and region (default: US; supported: US, SG, MY, PH, TH, VN, ID, JP, MX; GB and BR are unavailable). Suggestions appear in data.data as an array of strings; the list can vary by term and region and may be empty.
2.07 credits/call
Pricing
2.07 credits/call
| 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 |
|---|---|---|---|---|
lang | string | No | 语言/Language | en-US |
region | string | No | 地区代码/Region code: US, SG, MY, PH, TH, VN, ID, JP, MX。GB 和 BR 暂不支持 / GB and BR are unavailable. | US |
search_word | string | Yes | 搜索关键词/Search keyword | — |
Invocation example
Copy the request and explore its response example.
POST
/agent-api/v1/tool/executeX-Api-KeyRequest coderequest.sh
curl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_tiktok_shop_fetch_search_word_suggestion_v2' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"lang": "en-US",
"region": "US",
"search_word": "blue and white ring for women"
}
}'Response exampleresponse.json
{
"code": 200,
"data": {
"code": 0,
"data": [
"blue and white rings for women"
],
"message": "success"
},
"docs": "https://api.tikhub.io/#/TikTok-Shop-Web-API/fetch_search_word_suggestion_v2_api_v1_tiktok_shop_web_fetch_search_word_suggestion_v2_get",
"message": "Request successful. This request will incur a charge."
}This example shows part of the response. Copied content is valid JSON.

