Authentication
Initiate Authorization
Initiate TikTok Shop authorization flow
Parameters
string
required
The ID of the user
Response
Redirects to TikTok auth page or error page with the following URL structure:Authorization Callback
Callback endpoint for TikTok Shop authorization
Parameters
string
required
Authorization code from TikTok
string
required
State parameter containing userId and random string for security verification
string
Optional error message from TikTok if authorization fails
Response
Redirects to one of:- Success page:
/auth/success?platform=tiktok - Error page:
/auth/error?platform=tiktok&error=ERROR_MESSAGE
Refresh Token
Refresh TikTok Shop access token
Parameters
string
required
The ID of the user
Response
string
Success or error message
string
New token expiration timestamp
Shop Operations
Get Shop Info
Get TikTok Shop information
Parameters
string
required
The ID of the user
Response
string
TikTok Shop ID
string
Shop region code
string
Shop status (active/inactive)
Search Creators
Search for TikTok creators
Parameters
string
required
The ID of the user
string
Token for pagination
Response
array
List of creator profiles
string
Token for the next page of results
Advanced Creator Search
Advanced search for TikTok creators with filters
Parameters
string
required
The ID of the user
string
Token for pagination
Request Body
Response
array
List of filtered creator profiles
string
Token for the next page of results