Skip to main content
POST
Submit TikTok Shop User Showcase task

TikTok User Showcase

Collect products displayed in one public TikTok user’s Shop showcase.

Request Example

One task accepts one username. The @ prefix is optional.

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

Public TikTok username, with or without the @ prefix. One task accepts one username.

Minimum string length: 1
results_limit
integer
default:100

Maximum unique showcase 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