Skip to main content
POST
Submit TikTok Shop Search task

TikTok Shop Search

Search public products by keyword and market region.

Request Example

SocQ requests result pages until results_limit is reached or no additional products are available. Duplicate product IDs are saved once.

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
query
string
required

Product search query.

Minimum string length: 1
results_limit
integer
default:100

Maximum unique products to save across result pages.

Required range: 20 <= x <= 2000
region
enum<string>
default:US

TikTok Shop market region. Non-US catalog availability can vary.

Available options:
US,
GB,
DE,
FR,
IT,
ID,
MY,
MX,
PH,
SG,
ES,
TH,
VN,
BR,
JP,
IE
callback_url
string<uri>

Optional URL that receives the task completion callback.

Response

Task submitted

code
integer
Example:

200

data
object