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

Lấy insight video công khai TTO — API TikTok Business

Get TTO Public Media Insights · 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 Public Media Insights

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

Video công khai của một creator trên TikTok One Creator Marketplace kèm lượt xem / thích / bình luận / chia sẻ / lưu và trạng thái hợp tác — để đánh giá chất lượng nội dung trước khi mời hợp tác.

  • 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.
  • Tên người dùng chưa tham gia TikTok One Creator Marketplace → lỗi 40002.

Request

Địa chỉ

GET https://partner.quantri360.com/v1/tiktok_business/tto/tcm/creator/public/video/list/

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.
handle_namequerystringCócreator_mauTên người dùng (không có @) của creator, khớp chính xác.
video_idsquerystring[]KhôngMảng JSON id video cần lấy (tối đa 25). Không gửi = video mới nhất.
cursorqueryintKhông0Con trỏ thời gian (mili giây): lấy các video đăng TRƯỚC mốc này. Mặc định 0 = mới nhất. Trang kế: truyền data.page_info.cursor.
limitqueryintKhông25Số video mỗi lần: 1–25, mặc định 10.

Phân trang

Lặp khi data.page_info.has_more = true, truyền cursor = data.page_info.cursor cho lần gọi kế.

Ví dụ request

curl -s "https://partner.quantri360.com/v1/tiktok_business/tto/tcm/creator/public/video/list/?platform_shop_id=7000000000000000001&tto_tcm_account_id=7300000000000000001&handle_name=creator_mau&limit=25" \
  -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/creator/public/video/list/",
    params={
        "platform_shop_id": "7000000000000000001",
        "tto_tcm_account_id": "7300000000000000001",
        "handle_name": "creator_mau",
        "limit": 25
    },
    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/creator/public/video/list/');
for (const [k, v] of Object.entries({"platform_shop_id":"7000000000000000001","tto_tcm_account_id":"7300000000000000001","handle_name":"creator_mau","limit":25})) 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/creator/public/video/list/' . '?' . http_build_query(['platform_shop_id' => '7000000000000000001', 'tto_tcm_account_id' => '7300000000000000001', 'handle_name' => 'creator_mau', 'limit' => 25]);
$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.
postsobject[]Video công khai.
video_idstring7560000000000000001Id video.
display_namestringCreator mẫuTên hiển thị của creator.
captionstringMô tả video.
caption_hashtagsstring[]["ootd"]Hashtag trong mô tả.
mentioned_accountsstring[][]Tên hiển thị các tài khoản được @nhắc trong mô tả.
create_timestring1792797460000Thời điểm đăng, Unix **mili giây** (UTC).
video_viewsint12000Lượt xem.
likesint850Lượt thích.
commentsint40Lượt bình luận.
sharesint12Lượt chia sẻ.
favoritesint30Lượt lưu yêu thích.
thumbnail_urlstringẢnh bìa video — link TẠM (hạn khoảng 7 ngày, mốc hết hạn ở tham số `x-expires`, Unix giây).
embed_urlstringhttps://www.tiktok.com/player/v1/7560000000000000001Link nhúng video; bài để "Bạn bè" / "Chỉ mình tôi" không xem được qua link này.
collaboration_statusstringNONE`PAID_PARTNERSHIP` = bài đã gắn vào chiến dịch TikTok One · `CREATOR_EARNS_COMMISSION` = creator nhận hoa hồng affiliate TikTok Shop · `NONE` = không phải nội dung hợp tác.
page_infoobjectPhân trang.
has_morebooltrueCòn video.
cursorint1792797460000Mốc thời gian (mili giây) của video cuối trang này.

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