Skip to main content
POST
Submit TikTok Shop Products task

TikTok Shop Products

Collect products from one store URL, sorted by best sellers or newest releases.

Request Example

One task accepts one store URL. The final result can contain fewer records than results_limit when no additional page is available.

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
url
string<uri>
required

Public TikTok Shop store URL. One task accepts one store.

Pattern: ^https?://(?:[^/]+\.)?tiktok\.com/shop/store/[^/]+/[0-9]+
results_limit
integer
default:100

Maximum unique shop products to save across result pages.

Required range: 20 <= x <= 2000
sort_by
enum<string>
default:top

Sort products by best sellers or newest releases.

Available options:
top,
new_releases
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