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

Lấy báo cáo phân tích video của creator TTO đã ủy quyền — API TikTok Business

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

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

Video của chính tài khoản TikTok đã nối (creator TikTok One) kèm lượt xem / thích / bình luận / chia sẻ / lưu và trạng thái hợp tác.

  • Gọi bằng TÀI KHOẢN TIKTOK đã nối (platform_shop_id = tài sản kind = business_account ở GET /v1/platforms) và gửi creator_id bằng chính id đó. Chỉ xem được tài khoản đã ủy quyền cho 360, đã tham gia TikTok One.
  • Khác /tto/tcm/creator/public/video/list/: has_more / cursor nằm thẳng trong data (không có page_info), mỗi lần tối đa 10 video.

Request

Địa chỉ

GET https://partner.quantri360.com/v1/tiktok_business/tto/creator/authorized/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ả
creator_idquerystringCó-000AbCdEfGhIjKlMnOpQrStUvWxYz012345Id tài khoản TikTok đã nối = ĐÚNG platform_shop_id đang gọi. 360 KHÔNG tự điền tham số này — bạn tự gửi.
video_idsquerystring[]KhôngMảng JSON id video cần lấy. Có video_ids thì limit và cursor bị bỏ qua.
cursorqueryintKhông0Con trỏ thời gian (mili giây): lấy video đăng TRƯỚC mốc này, mới trước. Mặc định 0 = mới nhất. Trang kế: truyền data.cursor.
limitqueryintKhông10Số video mỗi lần: 1–10, mặc định 10.

Phân trang

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

Ví dụ request

curl -s "https://partner.quantri360.com/v1/tiktok_business/tto/creator/authorized/video/list/?platform_shop_id=-000AbCdEfGhIjKlMnOpQrStUvWxYz012345&creator_id=-000AbCdEfGhIjKlMnOpQrStUvWxYz012345&limit=10" \
  -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/creator/authorized/video/list/",
    params={
        "platform_shop_id": "-000AbCdEfGhIjKlMnOpQrStUvWxYz012345",
        "creator_id": "-000AbCdEfGhIjKlMnOpQrStUvWxYz012345",
        "limit": 10
    },
    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/creator/authorized/video/list/');
for (const [k, v] of Object.entries({"platform_shop_id":"-000AbCdEfGhIjKlMnOpQrStUvWxYz012345","creator_id":"-000AbCdEfGhIjKlMnOpQrStUvWxYz012345","limit":10})) 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/creator/authorized/video/list/' . '?' . http_build_query(['platform_shop_id' => '-000AbCdEfGhIjKlMnOpQrStUvWxYz012345', 'creator_id' => '-000AbCdEfGhIjKlMnOpQrStUvWxYz012345', 'limit' => 10]);
$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ủa tài khoản.
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.
has_morebooltrueCòn video.
cursorint1792985098000Mố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