TikTokクリエイターの販売データを取得

TikTokクリエイターのTikTok Shop活動（宣伝商品、注文・販売合計、売上、商品リンク付きコンテンツの割合）を集計します。リクエストあたりのクォータ消費が大きいプレミアムなコマースエンドポイントです。

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

クォータ消費: このエンドポイントへの成功したリクエスト 1 件あたり、プランのクォータが 10 単位消費されます。

リクエストパラメータ

必須パラメータ

名前	位置	型	説明
`unique_id`	query	string	unique_id example: popmart.usshop

レスポンスフィールド

名前	型	説明
`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

お試し実行

リクエストURL

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

Authorization

ダッシュボードのAPIキーを選択

リクエストを送信する前にAPIキーを入力してください。ダッシュボードを開く

クエリパラメータ

unique_id*

cURL の例

bash

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

レスポンス例 (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"
  }
}

ユースケース

アフィリエイトクリエイター選定 — フォロワー数ではなく実証済みの売上で候補クリエイターを順位付けします。
コミッション予測 — クリエイターの過去の販売数量から、提携で見込める収益を推計します。