Get benchmarks for a business category
GET/business/benchmark/Gọi qua 360: GET https://partner.quantri360.com/v1/tiktok_business/business/benchmark/
Mô tả API
Chỉ số trung bình của ngành (lượt thích, bình luận, chia sẻ, lượt xem, người theo dõi, tăng trưởng, tỉ lệ tương tác) — so với số liệu tài khoản lấy ở /business/get/ để biết tài khoản đang trên hay dưới mặt bằng ngành.
- Số liệu là trung bình của các tài khoản doanh nghiệp đã xác minh trong ngành trên TikTok, không riêng thị trường Việt Nam và không phụ thuộc tài khoản đã chọn (tài khoản chỉ dùng để xác thực). Lượt thích / bình luận / chia sẻ / lượt xem tính trên video của chính các tài khoản đó.
Request
Địa chỉ
GET https://partner.quantri360.com/v1/tiktok_business/business/benchmark/
Xác thực & gian hàng
| Tên | Vị trí | Kiểu | Mẫu | Mô tả |
|---|---|---|---|---|
| Authorization | header | header | Bearer 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_id | query | string | 7000000000000000001 | Tà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ên | Vị trí | Kiểu | Bắt buộc | Mẫu | Mô tả |
|---|---|---|---|---|---|
| business_category | query | string | Có | CLOTHING_AND_ACCESSORIES | Ngành, một trong: ART_AND_CRAFTS (Thủ công mỹ nghệ) · AUTOMOTIVE_AND_TRANSPORTATION (Ô tô & vận tải) · BABY (Mẹ & bé) · BEAUTY (Làm đẹp) · CLOTHING_AND_ACCESSORIES (Thời trang & phụ kiện) · EDUCATION_AND_TRAINING (Giáo dục) · ELECTRONICS (Điện tử) · FINANCE_AND_INVESTING (Tài chính) · FOOD_AND_BEVERAGE (Ăn uống) · GAMING (Game) · HEALTH_AND_WELLNESS (Sức khỏe) · HOME_FURNITURE_AND_APPLIANCES (Nhà cửa, nội thất & gia dụng) · MACHINERY_AND_EQUIPMENT (Máy móc) · MEDIA_AND_ENTERTAINMENT (Giải trí) · PERSONAL_BLOG (Blog cá nhân) · PETS (Thú cưng) · PROFESSIONAL_SERVICES (Dịch vụ chuyên nghiệp) · PUBLIC_ADMINISTRATION (Cơ quan nhà nước) · REAL_ESTATE (Bất động sản) · RESTAURANTS_AND_BARS (Nhà hàng & quán bar) · SHOPPING_AND_RETAIL (Mua sắm & bán lẻ) · SOFTWARE_AND_APPS (Phần mềm) · SPORTS_FITNESS_AND_OUTDOORS (Thể thao) · TRAVEL_AND_TOURISM (Du lịch) · OTHERS (Khác). |
Ví dụ request
curl -s "https://partner.quantri360.com/v1/tiktok_business/business/benchmark/?platform_shop_id=-000AbCdEfGhIjKlMnOpQrStUvWxYz012345&business_category=CLOTHING_AND_ACCESSORIES" \ -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/benchmark/",
params={
"platform_shop_id": "-000AbCdEfGhIjKlMnOpQrStUvWxYz012345",
"business_category": "CLOTHING_AND_ACCESSORIES"
},
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/benchmark/');
for (const [k, v] of Object.entries({"platform_shop_id":"-000AbCdEfGhIjKlMnOpQrStUvWxYz012345","business_category":"CLOTHING_AND_ACCESSORIES"})) 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/benchmark/' . '?' . http_build_query(['platform_shop_id' => '-000AbCdEfGhIjKlMnOpQrStUvWxYz012345', 'business_category' => 'CLOTHING_AND_ACCESSORIES']); $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ên | Kiểu | Mẫu | Mô tả |
|---|---|---|---|
| code | int | 0 | 0 = 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ệ). |
| message | string | OK | Thông điệp của TikTok. |
| request_id | string | 2021080307532501024502410704A7306F | Mã request TikTok — ghi lại khi cần tra lỗi. |
| data | object | Dữ liệu. | |
| business_category | string | Clothing & Accessories | Tên ngành (dạng chữ, không phải mã gửi lên). |
| average_follower_count | float | 5793.8372 | Người theo dõi trung bình. |
| average_follower_growth | float | 69.4818 | Tăng người theo dõi trung bình trong 30 ngày gần nhất. |
| average_video_count | float | 338.3233 | Số video trung bình. |
| average_video_views | float | 3730568.8681 | Lượt xem video trung bình. |
| average_likes | float | 68108.6445 | Lượt thích trung bình. |
| average_comments | float | 1255.9245 | Bình luận trung bình. |
| average_shares | float | 4243.4588 | Chia sẻ trung bình. |
| average_engagement_rate | float | 0.0109 | Tỉ lệ tương tác trung bình (0–1). |
Bắt đầu dùng
- Đăng ký tài khoản Partner
- Mở loại dữ liệu thuộc nhóm Tài khoản TikTok (Organic API) ở trang nền tảng
- Tạo API key (tick kênh TikTok Business)
- Gọi theo ví dụ ở trên