VI | EN
Message us on Messenger
Developer resources

Get comments — TikTok Business API

Get comments · 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.

Get comments

GET/comment/list/Via 360: GET https://partner.quantri360.com/v1/tiktok_business/comment/list/
Description

Bình luận dưới video quảng cáo (cả quảng cáo thường lẫn Spark Ads) của một nhóm quảng cáo trong khoảng ngày. Khác /business/comment/list/ (bình luận dưới video tự nhiên của tài khoản TikTok).

  • Lấy id nhóm quảng cáo từ báo cáo / cấu hình nhóm quảng cáo của tài khoản.
  • Cần lịch sử dài hơn 30 ngày → gọi nhiều lần, mỗi lần một khoảng ≤ 30 ngày.
  • Dữ liệu cá nhân người bình luận (tên, ảnh, định danh) — chỉ dùng để chăm sóc khách / quản lý bình luận của chính tài khoản.

Request

Endpoint

GET https://partner.quantri360.com/v1/tiktok_business/comment/list/

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_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.

Request parameters

NameInTypeRequiredSampleDescription
search_fieldquerystringYesADGROUP_IDLuôn là ADGROUP_ID (lọc theo nhóm quảng cáo).
search_valuequerystringYes1820000000000000001Id nhóm quảng cáo.
start_timequerystringYes2026-10-01Từ ngày, YYYY-MM-DD.
end_timequerystringYes2026-10-27Đến ngày, YYYY-MM-DD. Khoảng start_time – end_time tối đa 30 ngày (quá → lỗi 40002).
comment_typequerystring[]No["ALL"]Mảng JSON: ALL (mặc định) · COMMENT (bình luận gốc) · REPLY (phản hồi).
sort_fieldquerystringNoCREATE_TIMECREATE_TIME (mặc định) · LIKES · REPLIES.
sort_typequerystringNoDESCDESC (mặc định) · ASC.
pagequeryintNo1Trang, từ 1.
page_sizequeryintNo100Số bình luận mỗi trang: 1–100, mặc định 10.

Pagination

Lặp page = 1, 2, … tới khi page ≥ data.page_info.total_page.

Request examples

curl -s "https://partner.quantri360.com/v1/tiktok_business/comment/list/?platform_shop_id=7000000000000000001&search_field=ADGROUP_ID&search_value=1820000000000000001&start_time=2026-10-01&end_time=2026-10-27&page_size=100" \
  -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/comment/list/",
    params={
        "platform_shop_id": "7000000000000000001",
        "search_field": "ADGROUP_ID",
        "search_value": "1820000000000000001",
        "start_time": "2026-10-01",
        "end_time": "2026-10-27",
        "page_size": 100
    },
    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/comment/list/');
for (const [k, v] of Object.entries({"platform_shop_id":"7000000000000000001","search_field":"ADGROUP_ID","search_value":"1820000000000000001","start_time":"2026-10-01","end_time":"2026-10-27","page_size":100})) 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/comment/list/' . '?' . http_build_query(['platform_shop_id' => '7000000000000000001', 'search_field' => 'ADGROUP_ID', 'search_value' => '1820000000000000001', 'start_time' => '2026-10-01', 'end_time' => '2026-10-27', 'page_size' => 100]);
$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 Business)

NameTypeSampleDescription
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.
commentsobject[]Bình luận.
comment_idstring7700000000000000001Id bình luận.
contentstringCòn size M không shop?Nội dung.
comment_typestringCOMMENT`COMMENT` · `REPLY`.
original_comment_idstringChỉ khi `REPLY`: id bình luận gốc.
comment_statusstringPUBLIC`PUBLIC` · `HIDDEN`.
hit_blockedwordboolfalseChứa từ bị chặn.
likesint3Lượt thích.
repliesint1Số phản hồi.
is_pinnedboolfalseĐã ghim.
can_deleteboolfalseXóa được không.
create_timestring2026-10-20 10:15:00Thời điểm bình luận.
user_namestringnguoi_dung_mauTên người dùng người bình luận.
user_idstring6123456789123456789Id người dùng TikTok.
user_avatar_urlstringẢnh đại diện.
campaign_idstring
campaign_namestring
adgroup_idstring
adgroup_namestring
ad_idstring
ad_namestring
ad_textstringTiêu đề quảng cáo.
tiktok_item_idstringId video TikTok.
video_play_urlstringLink phát video.
video_cover_urlstringẢnh bìa video.
identity_idstringDanh tính đăng quảng cáo.
identity_typestringTT_USER`TT_USER` (tài khoản TikTok) · `CUSTOMIZED_USER` (danh tính tùy chỉnh).
is_auth_ttbaboolNgười dùng đã liên kết tài khoản TikTok Business.
is_auth_comment_manage_scopeboolCó quyền quản lý bình luận.
appstringId ứng dụng.
page_infoobjectPhân trang.
pageint1Trang hiện tại.
page_sizeint100Số dòng mỗi trang.
total_numberint35Tổng số dòng.
total_pageint1Tổng số trang.

Get started

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