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

Lấy hashtag thương hiệu hợp lệ cho tài khoản TikTok — API TikTok Business

Get valid brand mention hashtags for a TikTok account · 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 valid brand mention hashtags for a TikTok account

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

Tối đa 100 hashtag thương hiệu hợp lệ của tài khoản — hashtag xuất hiện trong mô tả ít nhất 3 bài (bài của chính tài khoản hoặc bài có @nhắc tới tài khoản). Hashtag hợp lệ bật được để theo dõi bài đăng dùng hashtag 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 mới hoặc ít được nhắc tới tự nhiên thường không có hashtag hợp lệ (danh sách rỗng) — kiểm bằng tài khoản thật đang có lượt nhắc.
  • Bật hashtag hợp lệ để theo dõi: /business/mention/hashtag/add/.

Request

Địa chỉ

GET https://partner.quantri360.com/v1/tiktok_business/business/mention/hashtag/verify/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ả
usernamequerystringCóthuonghieu.officialTên người dùng (handle, không có @) của chính tài khoản — lấy username ở /business/get/.

Ví dụ request

curl -s "https://partner.quantri360.com/v1/tiktok_business/business/mention/hashtag/verify/list/?platform_shop_id=-000AbCdEfGhIjKlMnOpQrStUvWxYz012345&username=thuonghieu.official" \
  -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/verify/list/",
    params={
        "platform_shop_id": "-000AbCdEfGhIjKlMnOpQrStUvWxYz012345",
        "username": "thuonghieu.official"
    },
    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/verify/list/');
for (const [k, v] of Object.entries({"platform_shop_id":"-000AbCdEfGhIjKlMnOpQrStUvWxYz012345","username":"thuonghieu.official"})) 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/verify/list/' . '?' . http_build_query(['platform_shop_id' => '-000AbCdEfGhIjKlMnOpQrStUvWxYz012345', 'username' => 'thuonghieu.official']);
$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.
hashtag_listobject[]Hashtag hợp lệ, tối đa 100.
hashtagstringthuonghieuHashtag (không có dấu #).
post_countint35Số bài có hashtag trong mô tả, 90 ngày gần nhất.
like_countint12000Tổng lượt thích các bài đó, 90 ngày gần nhất.
mention_post_rankint1Thứ hạng của hashtag trong các hashtag hợp lệ của tài khoả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