Get TikTok Creator Sales Data

Summarises a TikTok creator's TikTok Shop activity — promoted products, order and sales totals, revenue and the share of content that carries product links. This is a premium commerce endpoint with a higher per-request quota cost.

GET/api/v1/tiktok/user/shop/sale

Quota usage: Each successful request to this endpoint deducts 10 quota units from your plan.

Request Parameters

Required Parameters

Name	In	Type	Description
`unique_id`	query	string	unique_id example: popmart.usshop

Response Fields

Name	Type	Description
`success`	boolean	Success
`code`	integer	Code
`message`	string	Message
`data`	object	-
`data.currency_symbol`	string	Currency symbol
`data.revenue_amount`	string	Revenue (last 30 days)
`data.sales_volumn`	integer	Units sold (last 30 days)
`data.video_revenue_amount`	string	Video revenue (last 30 days)
`data.live_revenue_amount`	string	Livestream revenue (last 30 days)
`data.avg_sales_price`	string	Average selling price (last 30 days)
`data.live_views_number`	integer	Livestream views (last 30 days)
`data.video_views_number`	integer	Video views (last 30 days)
`data.new_followers_number`	integer	New followers (last 30 days)
`data.start_time`	string	Start time
`data.end_time`	string	End time

Try It

Request URL

https://openapi.scdata.cc/api/v1/tiktok/user/shop/sale

Authorization

Select an API key from Dashboard

Add an API key before sending a request.Go to Dashboard

Query Params

unique_id*

cURL Example

bash

curl -X GET "https://openapi.scdata.cc/api/v1/tiktok/user/shop/sale?unique_id=popmart.usshop" \
  -H "Authorization: YOUR_API_KEY"

Response Example (200 application/json)

json

{
  "success": true,
  "code": 200,
  "message": "Request successful",
  "data": {
    "currency_symbol": "$",
    "revenue_amount": "3132136.98",
    "sales_volumn": 83007,
    "video_revenue_amount": "309.90",
    "live_revenue_amount": "3123058.84",
    "avg_sales_price": "37.73",
    "live_views_number": 22712398,
    "video_views_number": 13409031,
    "new_followers_number": 53000,
    "start_time": "2025-08-01",
    "end_time": "2025-08-31"
  }
}

Use Cases

Affiliate creator selection — Rank candidate creators by proven sales rather than follower count.
Commission forecasting — Estimate the revenue a partnership could generate from a creator's historical sales volume.