VI | EN
Message us on Messenger
Developer resources

Nội dung creator trong open collaboration — TikTok Shop API

tiktok.affiliate_seller.202508.open_collaborations.creator_content_details · call it through Quantri360 with one API key for your own accounts / assets that you connected and authorized — 360 handles request signing and refreshing the authorization you granted.

tiktok.affiliate_seller.202508.open_collaborations.creator_content_details

GET/affiliate_seller/202508/open_collaborations/creator_content_detailsVia 360: GET https://partner.quantri360.com/v1/tiktok/affiliate_seller/202508/open_collaborations/creator_content_details
Description

Danh sách creator đang quảng bá MỘT sản phẩm qua hợp tác mở (open collaboration): hồ sơ creator, số follower, số video / LIVE đã đăng cho sản phẩm, trạng thái quảng bá — dùng để biết KOC nào đang bán giúp sản phẩm nào.

  • Gọi qua /v1/tiktok/affiliate_seller/202508/open_collaborations/creator_content_details với Authorization: Bearer <key>; dùng platform_shop_id khi có nhiều shop. 360 tự gắn app_key, shop_cipher, sign và access_token.
  • promotion_end_time = 7258118400 (năm 2200) = không giới hạn thời gian.
  • Creator có trong danh sách khi đã thêm sản phẩm vào showcase — video_count = 0 và live_count = 0 nghĩa là mới thêm, chưa đăng nội dung.
  • Sản phẩm không thuộc hợp tác mở nào → danh sách rỗng.
  • API chỉ đọc; code = 0 mới là thành công.

Request

Endpoint

GET https://partner.quantri360.com/v1/tiktok/affiliate_seller/202508/open_collaborations/creator_content_details

Authentication & shop

NameInTypeSampleDescription
AuthorizationheaderheaderBearer q360_live_ab12cd34_…Khóa API của brand (tạo ở mục API key). Bắt buộc với mọi request. Brand suy từ key — không truyền mã brand.
platform_shop_idquerystring100001Gian hàng (lấy ở GET /v1/platforms → shops[].platform_shop_id). BẮT BUỘC khi brand có > 1 gian hàng trên nền tảng; 360 bỏ tham số này trước khi chuyển tiếp.

Request parameters

NameInTypeRequiredSampleDescription
product_idquerystringYes9000000000000000033Mã sản phẩm TikTok.
page_sizequeryintYes501–100.
page_tokenquerystringNonext_page_token của trang trước (giữ nguyên product_id, page_size).

Pagination

Lặp khi data.next_page_token khác rỗng, thêm query page_token.

Request examples

curl -s "https://partner.quantri360.com/v1/tiktok/affiliate_seller/202508/open_collaborations/creator_content_details?page_size=20&product_id=100000000000000101" \
  -H "Authorization: Bearer $KEY"
Python
import requests

KEY = "q360_live_..."  # khóa API của brand
r = requests.get(
    "https://partner.quantri360.com/v1/tiktok/affiliate_seller/202508/open_collaborations/creator_content_details",
    params={
        "page_size": 20,
        "product_id": "100000000000000101"
    },
    headers={"Authorization": f"Bearer {KEY}"},
    timeout=60,
)
print(r.status_code)
print(r.json())
Node.js
const KEY = 'q360_live_...'; // khóa API của brand
const url = new URL('https://partner.quantri360.com/v1/tiktok/affiliate_seller/202508/open_collaborations/creator_content_details');
for (const [k, v] of Object.entries({"page_size":20,"product_id":"100000000000000101"})) 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
<?php
$key = 'q360_live_...'; // khóa API của brand
$url = 'https://partner.quantri360.com/v1/tiktok/affiliate_seller/202508/open_collaborations/creator_content_details' . '?' . http_build_query(['page_size' => 20, 'product_id' => '100000000000000101']);
$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)

NameTypeSampleDescription
codeint00 = thành công; khác 0 xem message (105001–105003 = token, 360 đã tự làm mới một lần).
messagestringSuccessThông điệp của TikTok.
request_idstringDEMO_AFFILIATE_REQUESTMã request TikTok.
dataobjectDữ liệu.
total_countint1Tổng creator khớp.
next_page_tokenstringRỗng = hết.
productobjectSản phẩm đang tra.
idstring100000000000000101Mã định danh.
image_urlstringhttps://example.com/minh-hoaẢnh chính.
creator_content_detailsobject[]Mỗi creator một phần tử.
creator_profileobjectHồ sơ creator.
usernamestringcreator_minh_hoaTên tài khoản TikTok.
nicknamestringCreator minh họaTên hiển thị.
follower_countint1Số người theo dõi.
avatarobject{url} ảnh đại diện (link có hạn dùng).
creator_open_idstringCREATOR_DEMO_001Định danh creator ổn định — dùng khi tạo / sửa hợp tác mục tiêu.
video_countint1Số video creator đã đăng cho sản phẩm.
live_countint1Số LIVE.
promotion_statusstringMinh họa`NORMAL` (đang quảng bá) · `TERMINATING` (người bán đã yêu cầu dừng, sắp hết quyền).
promotion_end_timeint1790812800Hết quyền quảng bá lúc (Unix giây).

Response sample

{
  "code": 0,
  "message": "Success",
  "request_id": "DEMO_AFFILIATE_REQUEST",
  "data": {
    "total_count": 1,
    "next_page_token": "",
    "product": {
      "id": "100000000000000101",
      "image_url": "https://example.com/minh-hoa"
    },
    "creator_content_details": [
      {
        "creator_profile": {
          "username": "creator_minh_hoa",
          "nickname": "Creator minh họa",
          "follower_count": 1,
          "avatar": {},
          "creator_open_id": "CREATOR_DEMO_001"
        },
        "video_count": 1,
        "live_count": 1,
        "promotion_status": "Minh họa",
        "promotion_end_time": 1790812800
      }
    ]
  }
}

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