Skip to main content
POST
TikTok Shop Search Suggestions API

TikTok Shop Search Suggestions

See how shoppers finish a search on TikTok Shop. Type the start of a query and get up to 20 completions in the order TikTok Shop suggests them. Suggestions come from what people actually search, so they surface product variants, compatible models and buying angles worth targeting in listings, ads and content.
Provide the start of a shopping search in query. region defaults to US; US, SG, MY, PH, TH, VN, ID, JP and MX are available. Each call costs 0.5 credits and returns up to 20 completions ranked from 1.

Standard Result Fields

Task results use the stable SocQ fields below. Source-specific field names and formats are normalized without inferring or enriching values that the source did not provide. To request a smaller field set, use fields for MCP queries, _result_fields for typed tools, or --result-fields in the CLI. Declared fields remain present when their value is null. The following example shows the response format for a completed task. Actual data depends on your query.

Completed Task Response

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Provide the start of a shopping search in query. region defaults to US. Each call returns up to 20 completions in the order TikTok Shop suggests them.

query
string
required

Search query.

Minimum string length: 1
callback_url
string<uri>
region
enum<string>
default:US

Country or region code of the TikTok Shop market.

Available options:
ID,
JP,
MX,
MY,
PH,
SG,
TH,
US,
VN
Minimum string length: 1

Response

Task accepted

code
integer
data
object