Get Marketplace Creator Performance — TikTok Shop API

tiktok.affiliate_seller.202608.marketplace_creators.creator_user_id

Request

Endpoint

Authentication & shop

Request parameters

Request examples

curl -s "https://partner.quantri360.com/v1/tiktok/affiliate_seller/202608/marketplace_creators/CREATOR_DEMO_001" \
  -H "Authorization: Bearer $KEY"

import requests

KEY = "q360_live_..."  # khóa API của brand
r = requests.get(
    "https://partner.quantri360.com/v1/tiktok/affiliate_seller/202608/marketplace_creators/CREATOR_DEMO_001",
    params={},
    headers={"Authorization": f"Bearer {KEY}"},
    timeout=60,
)
print(r.status_code)
print(r.json())

const KEY = 'q360_live_...'; // khóa API của brand
const url = new URL('https://partner.quantri360.com/v1/tiktok/affiliate_seller/202608/marketplace_creators/CREATOR_DEMO_001');
for (const [k, v] of Object.entries({})) url.searchParams.set(k, typeof v === 'object' ? JSON.stringify(v) : String(v));
const r = await fetch(url, {
  method: 'GET',
  headers: { Authorization: `Bearer ${KEY}` },
});
console.log(r.status, await r.json());

<?php
$key = 'q360_live_...'; // khóa API của brand
$url = 'https://partner.quantri360.com/v1/tiktok/affiliate_seller/202608/marketplace_creators/CREATOR_DEMO_001' . '?' . http_build_query([]);
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer ' . $key]);
$res = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
echo $status, "\n", $res;

Response

Response fields (as returned by TikTok Shop)

Response sample

{
  "code": 0,
  "message": "Success",
  "request_id": "DEMO_AFFILIATE_REQUEST",
  "data": {
    "creator": {
      "username": "creator_minh_hoa",
      "nickname": "Creator minh họa",
      "avatar": {
        "url": "https://example.com/minh-hoa"
      },
      "selection_region": "VN",
      "bio_description": "Minh họa",
      "follower_count": 1,
      "profile_tt_uri": "DEMO_FILE_URI",
      "category_ids": [
        "100000000000000101"
      ],
      "top_collaborated_brand_ids": [
        "100000000000000101"
      ],
      "brand_collaboration_count": 1,
      "units_sold": 1,
      "units_sold_range": {
        "minimum_amount": 10000,
        "maximum_amount": 10000,
        "formatted_range": "1000000~2000000"
      },
      "gmv": {
        "currency": "VND",
        "amount": "10000"
      },
      "video_gmv": {
        "currency": "VND",
        "amount": "10000"
      },
      "live_gmv": {
        "currency": "VND",
        "amount": "10000"
      },
      "gmv_range": {
        "currency": "VND",
        "minimum_amount": "10000",
        "maximum_amount": "10000",
        "formatted_range": "1000000~2000000"
      },
      "ec_live_engagement_rate": "Minh họa",
      "category_gmv_distribution": [
        {
          "category_id": "100000000000000101",
          "value": "Minh họa"
        }
      ],
      "content_gmv_distribution": [
        {
          "content_type": "VIDEO",
          "value": "Minh họa"
        }
      ],
      "product_original_price_range": {
        "currency": "VND",
        "minimum_amount": "10000",
        "maximum_amount": "10000"
      },
      "gpm": {
        "currency": "VND",
        "amount": "10000"
      },
      "live_gpm": {
        "currency": "VND",
        "amount": "10000"
      },
      "video_gpm": {
        "currency": "VND",
        "amount": "10000"
      },
      "gpm_range": {
        "currency": "VND",
        "minimum_amount": "10000",
        "maximum_amount": "10000",
        "formatted_range": "1000000~2000000"
      },
      "video_gpm_range": {
        "currency": "VND",
        "minimum_amount": "10000",
        "maximum_amount": "10000",
        "formatted_range": "1000000~2000000"
      },
      "live_gpm_range": {
        "currency": "VND",
        "minimum_amount": "10000",
        "maximum_amount": "10000",
        "formatted_range": "1000000~2000000"
      },
      "promoted_product_num": 1,
      "ec_live_count": 1,
      "ec_video_count": 1,
      "avg_ec_video_play_count": 1,
      "avg_commission_rate": 1,
      "avg_commission_rate_range": {
        "minimum_amount": 10000,
        "maximum_amount": 10000
      },
      "avg_gmv_per_buyer": {
        "currency": "VND",
        "amount": "10000"
      },
      "avg_gmv_per_buyer_range": {
        "currency": "VND",
        "minimum_amount": "10000",
        "maximum_amount": "10000",
        "formatted_range": "1000000~2000000"
      },
      "avg_ec_live_view_count": 1,
      "avg_ec_live_like_count": 1,
      "avg_ec_live_comment_count": 1,
      "avg_ec_live_share_count": 1,
      "avg_ec_video_like_count": 1,
      "avg_ec_video_comment_count": 1,
      "avg_ec_video_share_count": 1,
      "follower_location": [
        {
          "key": "Minh họa",
          "value": "Minh họa"
        }
      ],
      "follower_age": [
        {
          "key": "Minh họa",
          "value": "Minh họa"
        }
      ],
      "follower_gender": [
        {
          "key": "Minh họa",
          "value": "Minh họa"
        }
      ],
      "pps": "Minh họa",
      "rating": "Minh họa",
      "ec_video_engagement_rate": "Minh họa",
      "post_rate": "GOOD",
      "creator_profile": {
        "is_official_recommend": false,
        "contact_info_available": false,
        "creator_bind_mcn_name": "Đơn vị minh họa",
        "live_engagement_rate_30d": 1,
        "video_play_cnt_30d_med": 1,
        "live_view_cnt_30d_med": 1,
        "live_like_cnt_30d": 1,
        "live_comment_cnt_30d_med": 1,
        "live_share_cnt_30d_med": 1,
        "video_publish_cnt_30d_med": 1,
        "has_invited_90d": false,
        "is_creator_blocked": false,
        "creator_level": 1,
        "creator_fulfillment_reviews": 1,
        "is_eligible_flat_fee": false,
        "is_rising_star": false,
        "creator_fulfillment_score_90d": "Minh họa",
        "sample_score": 1,
        "creator_connect_info": {
          "is_paired": false,
          "is_connect": false,
          "is_blocked": false
        },
        "creator_trend_profile": [
          {
            "start_timestamp": 1790812800,
            "end_timestamp": 1790812800,
            "gmv": {
              "amount": "10000",
              "symbol": "Minh họa"
            },
            "units_sold": 1,
            "follower": 1,
            "engagement_rate": 1
          }
        ]
      }
    }
  }
}

Get started

1. Sign up for Partner
2. Enable a data type of the Affiliate group on the platform page
3. Create an API key (tick the TikTok Shop channel)
4. Call it as in the examples above