TikTok Shop V2 API: Get TikTok Shop search suggestions

Returns autocomplete and related search terms for a partial keyword, as an array of strings. lang sets the suggestion language and region the storefront.

2 credits / requestBilled only on success

Authorization

ApiKeyAuth

x-api-key<token>

In: header

Query Parameters

keyword*string

Partial search text to complete, for example wire.

Length1 <= length

lang?string

Language code of the suggestions, for example en-US.

Default"en-US"

region?string

TikTok Shop storefront region code. Results, prices, and availability are region-specific.

Default"US"

Value in

"US"
"GB"
"SG"
"MY"
"PH"
"TH"
"VN"
"ID"

clean?string

Defaults to true. Set false to get the unshaped source payload; its shape is not guaranteed to match the documented response schema.

Defaulttrue

curl -X GET "https://example.com/v2/tiktok-shop/products/search/suggestions?keyword=phone" \  -H "x-api-key: YOUR_API_KEY"

{  "data": [    "string"  ]}