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

Lấy chỉ số chuẩn theo danh mục ngành — API TikTok Business

Get benchmarks for a business category · 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 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ê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ả
business_categoryquerystringCóCLOTHING_AND_ACCESSORIESNgà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ê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.
business_categorystringClothing & AccessoriesTên ngành (dạng chữ, không phải mã gửi lên).
average_follower_countfloat5793.8372Người theo dõi trung bình.
average_follower_growthfloat69.4818Tăng người theo dõi trung bình trong 30 ngày gần nhất.
average_video_countfloat338.3233Số video trung bình.
average_video_viewsfloat3730568.8681Lượt xem video trung bình.
average_likesfloat68108.6445Lượt thích trung bình.
average_commentsfloat1255.9245Bình luận trung bình.
average_sharesfloat4243.4588Chia sẻ trung bình.
average_engagement_ratefloat0.0109Tỉ lệ tương tác trung bình (0–1).

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