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

Lấy từ khóa thường dùng trong 1.000 bài đăng nhắc đến nhiều nhất — API TikTok Business

Get frequent keywords used in top 1000 mentioned 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 frequent keywords used in top 1000 mentioned posts

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

20 từ khóa xuất hiện nhiều nhất trong mô tả các bài đăng có @nhắc tới tài khoản (90 ngày gần nhất) — biết khách đang nói gì khi nhắc tới thương hiệu.

  • 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 đăng công khai, đăng trong 90 ngày gần nhất, có @nhắc đúng tên người dùng của tài khoản trong mô tả bài, và người đăng không thuộc diện chưa đủ tuổi hoặc không rõ tuổi (châu Âu: từ 17 tuổi trở xuống; nơi khác: từ 12 tuổi trở xuống).

Request

Địa chỉ

GET https://partner.quantri360.com/v1/tiktok_business/business/mention/top_word/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ả
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 từ khóa trong bài của người dùng đăng ký TikTok ở các nước đó. Không gửi = mọi quốc gia.

Ví dụ request

curl -s "https://partner.quantri360.com/v1/tiktok_business/business/mention/top_word/list/?platform_shop_id=-000AbCdEfGhIjKlMnOpQrStUvWxYz012345&regions=%5B%22VN%22%5D" \
  -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/top_word/list/",
    params={
        "platform_shop_id": "-000AbCdEfGhIjKlMnOpQrStUvWxYz012345",
        "regions": [
            "VN"
        ]
    },
    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/top_word/list/');
for (const [k, v] of Object.entries({"platform_shop_id":"-000AbCdEfGhIjKlMnOpQrStUvWxYz012345","regions":["VN"]})) 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/top_word/list/' . '?' . http_build_query(['platform_shop_id' => '-000AbCdEfGhIjKlMnOpQrStUvWxYz012345', 'regions' => '["VN"]']);
$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.
resultsobject[]Tối đa 20 từ khóa.
wordstringđẹpTừ hoặc cụm từ.
countint72Số lần xuất hiện.

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