Skip to main content

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 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