VI | EN
Nhắn Messenger
Dành cho developer

Lấy danh sách chiến dịch TTO Creator Marketplace — API TikTok Business

Get TTO Creator Marketplace campaigns · gọi qua Quantri360 bằng một API key cho chính tài khoản / tài sản bạn đã kết nối và ủy quyền — 360 lo việc ký request và làm mới phiên đăng nhập bạn đã cấp.

Get TTO Creator Marketplace campaigns

GET/tto/tcm/campaign/Gọi qua 360: GET https://partner.quantri360.com/v1/tiktok_business/tto/tcm/campaign/
Mô tả API

Danh sách chiến dịch TikTok One Creator Marketplace của tài khoản: tên, thương hiệu, creator được mời, link mời, video đã gắn, tài khoản quảng cáo nhận ủy quyền Spark Ads.

  • Gọi bằng TÀI KHOẢN QUẢNG CÁO đã nối (platform_shop_id = id tài khoản quảng cáo), không phải tài khoản TikTok. Chưa biết tto_tcm_account_id của bạn → liên hệ 360.
  • Chưa có chiến dịch → campaigns rỗng (đã kiểm cả CAMPAIGN và BRAND_LINK: code 0).

Request

Địa chỉ

GET https://partner.quantri360.com/v1/tiktok_business/tto/tcm/campaign/

Xác thực & gian hàng

TênVị tríKiểuMẫuMô tả
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_idquerystring7000000000000000001Tài sản TikTok Business đã kết nối — "Mã tài sản" ở trang Nền tảng hoặc GET /v1/platforms (tài khoản quảng cáo cho Marketing API, tài khoản TikTok cho Organic / Messaging). Có thể bỏ khi chỉ kết nối một tài sản.

Tham số request

TênVị tríKiểuBắt buộcMẫuMô tả
tto_tcm_account_idquerystringCó7300000000000000001Id tài khoản TikTok One Creator Marketplace mà tài khoản quảng cáo đã nối được quyền truy cập. Chưa biết id của bạn → liên hệ 360.
campaign_idsquerystring[]KhôngMảng JSON id chiến dịch (tối đa 5).
campaign_typequerystringKhôngCAMPAIGNCAMPAIGN = chiến dịch có link mời riêng của chiến dịch (gắn video vào đúng chiến dịch) · BRAND_LINK = chiến dịch dùng link mời cấp thương hiệu (gắn video vào thương hiệu, creator TikTok One nào cũng tham gia được). Mặc định CAMPAIGN — muốn đủ thì gọi cả hai loại.
pagequeryintKhông1Trang, từ 1. Mặc định 1.
page_sizequeryintKhông5Số dòng mỗi trang: 1–5, mặc định 5.

Phân trang

Lặp page = 1, 2, … tới khi page ≥ data.page_info.total_page. Mỗi trang tối đa 5 chiến dịch.

Ví dụ request

curl -s "https://partner.quantri360.com/v1/tiktok_business/tto/tcm/campaign/?platform_shop_id=7000000000000000001&tto_tcm_account_id=7300000000000000001&campaign_type=CAMPAIGN&page_size=5" \
  -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_business/tto/tcm/campaign/",
    params={
        "platform_shop_id": "7000000000000000001",
        "tto_tcm_account_id": "7300000000000000001",
        "campaign_type": "CAMPAIGN",
        "page_size": 5
    },
    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_business/tto/tcm/campaign/');
for (const [k, v] of Object.entries({"platform_shop_id":"7000000000000000001","tto_tcm_account_id":"7300000000000000001","campaign_type":"CAMPAIGN","page_size":5})) 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_business/tto/tcm/campaign/' . '?' . http_build_query(['platform_shop_id' => '7000000000000000001', 'tto_tcm_account_id' => '7300000000000000001', 'campaign_type' => 'CAMPAIGN', 'page_size' => 5]);
$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

Tham số phản hồi (nguyên của TikTok Business)

TênKiểuMẫuMô tả
codeint00 = thành công; khác 0 xem `message` (TikTok trả HTTP 200 kèm code lỗi; vd 40002 = tham số sai, message liệt kê giá trị hợp lệ).
messagestringOKThông điệp của TikTok.
request_idstring2021080307532501024502410704A7306FMã request TikTok — ghi lại khi cần tra lỗi.
dataobjectDữ liệu.
campaignsobject[]Chiến dịch.
campaign_idstring7430000000000000001Id chiến dịch.
campaign_typestringCAMPAIGN`CAMPAIGN` = chiến dịch có link mời riêng của chiến dịch (gắn video vào đúng chiến dịch) · `BRAND_LINK` = chiến dịch dùng link mời cấp thương hiệu (gắn video vào thương hiệu, creator TikTok One nào cũng tham gia được).
brand_profile_idstringId hồ sơ thương hiệu gắn với chiến dịch.
brand_namestringThương hiệu mẫuTên thương hiệu.
campaign_namestringÁo sơ mi linen - mát mùa hèTên chiến dịch.
campaign_descriptionstringMô tả chiến dịch.
handle_namesstring[]["creator_mau"]Creator được mời. Có danh sách = chỉ creator được mời mới tham gia; rỗng = creator nào cũng tham gia được.
anchor_idstringId anchor (link trang web) gắn với chiến dịch.
advertiser_idsstring[]["7000000000000000001"]Tài khoản quảng cáo gắn với chiến dịch — video creator đưa vào chiến dịch tự cấp quyền Spark Ads cho các tài khoản này.
spark_ads_requested_authorization_daysint30Số ngày ủy quyền Spark Ads mặc định cho video creator đưa vào chiến dịch: 0 · 7 · 30 · 60 · 180 · 365.
invite_linkstringhttps://www.tiktok.com/t/ZSAbCdEfG/Link mời gửi cho creator — không hết hạn.
create_timestring2026-10-27 08:00:00Thời điểm tạo, `YYYY-MM-DD HH:MM:SS` giờ UTC (cộng 7 ra giờ Việt Nam).
country_codesstring[]["VN"]Quốc gia của các creator đã mời — quốc gia dùng khi xem báo cáo chiến dịch.
video_idsstring[]Video đã gắn vào chiến dịch.
page_infoobjectPhân trang.
pageint1Trang hiện tại.
page_sizeint10Số dòng mỗi trang.
total_numberint0Tổng số dòng.
total_pageint0Tổng số trang.
dm_infoobjectNhắn tin trực tiếp với thương hiệu từ link mời.
business_account_handlestringthuonghieu.officialTên người dùng tài khoản TikTok Business gắn với chiến dịch.
dm_allowedboolfalse`true` = creator nhắn tin được cho thương hiệu khi mở link mời.

Bắt đầu dùng

  1. Đăng ký tài khoản Partner
  2. Mở loại dữ liệu thuộc nhóm Tài khoản TikTok (Organic API) ở trang nền tảng
  3. Tạo API key (tick kênh TikTok Business)
  4. Gọi theo ví dụ ở trên