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

Lấy nội dung nhắc đến cho 1.000 bài đăng hashtag thương hiệu hàng đầu — API TikTok Business

Get mention content for top 1000 brand hashtag posts · 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 mention content for top 1000 brand hashtag posts

GET/business/mention/hashtag/video/list/Gọi qua 360: GET https://partner.quantri360.com/v1/tiktok_business/business/mention/hashtag/video/list/
Mô tả API

Tối đa 1.000 bài đăng công khai (90 ngày gần nhất) có dùng hashtag thương hiệu đã bật của tài khoản — gộp mọi hashtag đã bật hoặc theo một hashtag.

  • Chỉ dùng được với tài khoản TikTok có Advanced Access hoặc tài khoản doanh nghiệp đã xác minh — kiểm has_advanced_access = true ở /business/get/. Tài khoản phải được ủy quyền với quyền biz.brand.insights.
  • Chỉ tính bài công khai, đăng trong 90 ngày gần nhất, người đăng không thuộc diện chưa đủ tuổi hoặc không rõ tuổi. Có hơn 1.000 bài → chỉ lấy 1.000 bài nhiều lượt thích nhất.
  • Hashtag mới bật có dữ liệu sau 24 giờ.

Request

Địa chỉ

GET https://partner.quantri360.com/v1/tiktok_business/business/mention/hashtag/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ả
hashtagquerystringKhôngthuonghieuChỉ lấy bài của MỘT hashtag đã bật (phân biệt hoa thường, phải khớp đúng). Không gửi = gộp mọi hashtag đã bật. Danh sách đã bật: /business/mention/hashtag/manage/list/.
fieldsquerystring[]Không["item_id","create_time","video_link","caption","likes","comments","shares","matched_hashtags"]Mảng JSON các trường cần lấy. Không gửi = chỉ item_id, caption. Chọn được: item_id, create_time, video_link, caption, likes, comments, shares, thumbnail_url, matched_hashtags.
sort_fieldquerystringKhôngLIKESSắp theo: CREATE_TIME (mặc định) · LIKES · COMMENTS · SHARES.
sort_orderquerystringKhôngDESCDESC (mặc định, giảm dần) · ASC. Lưu ý tên tham số là sort_order (các API lượt nhắc khác dùng sort_type).
number_of_daysqueryintKhông30Số ngày nhìn lại: 1–90, mặc định 90.
regionsquerystring[]Không["VN"]Mảng JSON mã quốc gia 2 chữ cái (ISO 3166-1, vd VN, US, TH) để chỉ lấy bài của người dùng đăng ký TikTok ở các nước đó. Không gửi = mọi quốc gia.
cursorqueryintKhông0Con trỏ trang = VỊ TRÍ trong danh sách (không phải mốc thời gian), mặc định 0. Trang kế: truyền data.cursor của trang trước (vd 100 = bắt đầu sau bài thứ 100).
max_countqueryintKhông100Số bài mỗi trang, mặc định 10, tối đa 100. TikTok có thể trả ít hơn dù has_more = true.

Phân trang

Lặp khi data.has_more = true, truyền cursor = data.cursor cho lần gọi kế; tối đa 1.000 bài cho mỗi bộ lọc.

Ví dụ request

curl -s "https://partner.quantri360.com/v1/tiktok_business/business/mention/hashtag/video/list/?platform_shop_id=-000AbCdEfGhIjKlMnOpQrStUvWxYz012345&fields=%5B%22item_id%22%2C%22create_time%22%2C%22video_link%22%2C%22caption%22%2C%22likes%22%2C%22comments%22%2C%22shares%22%2C%22matched_hashtags%22%5D&sort_field=LIKES&sort_order=DESC&max_count=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/business/mention/hashtag/video/list/",
    params={
        "platform_shop_id": "-000AbCdEfGhIjKlMnOpQrStUvWxYz012345",
        "fields": [
            "item_id",
            "create_time",
            "video_link",
            "caption",
            "likes",
            "comments",
            "shares",
            "matched_hashtags"
        ],
        "sort_field": "LIKES",
        "sort_order": "DESC",
        "max_count": 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/business/mention/hashtag/video/list/');
for (const [k, v] of Object.entries({"platform_shop_id":"-000AbCdEfGhIjKlMnOpQrStUvWxYz012345","fields":["item_id","create_time","video_link","caption","likes","comments","shares","matched_hashtags"],"sort_field":"LIKES","sort_order":"DESC","max_count":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/business/mention/hashtag/video/list/' . '?' . http_build_query(['platform_shop_id' => '-000AbCdEfGhIjKlMnOpQrStUvWxYz012345', 'fields' => '["item_id","create_time","video_link","caption","likes","comments","shares","matched_hashtags"]', 'sort_field' => 'LIKES', 'sort_order' => 'DESC', 'max_count' => 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

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.
videosobject[]Bài dùng hashtag thương hiệu (chỉ có các trường đã yêu cầu ở `fields`).
item_idstring7650000000000000001Id bài.
create_timestring1792797460Thời điểm đăng, Unix giây (UTC).
video_linkstringhttps://www.tiktok.com/@/video/7650000000000000001Link bài.
captionstringMô tả bài.
likesint243Lượt thích.
commentsint10Lượt bình luận.
sharesint10Lượt chia sẻ.
thumbnail_urlstringẢnh thu nhỏ — link TẠM, hạn 48 giờ (mốc hết hạn ở tham số `x-expires`, Unix giây). Bài dạng ảnh: chuỗi rỗng `""`.
matched_hashtagsstring[]["thuonghieu"]Hashtag thương hiệu có trong mô tả bài. Khi đã lọc theo `hashtag` → mảng rỗng `[]`.
cursorint100Con trỏ trang kế (vị trí).
has_moreboolfalseCòn trang kế.

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