Get profile data of a TikTok account
GET/business/get/Gọi qua 360: GET https://partner.quantri360.com/v1/tiktok_business/business/get/
Mô tả API
Hồ sơ và số liệu của tài khoản TikTok Business: thông tin trang cá nhân, số người theo dõi / lượt thích / số video, số liệu theo ngày (lượt xem, tương tác, người theo dõi mới, giờ hoạt động của người theo dõi) và chân dung người theo dõi (tuổi, giới tính, quốc gia, thành phố).
- Số liệu ngày và chân dung người theo dõi trễ 24–48 giờ; chỉ có khi TikTok Analytics của tài khoản có dữ liệu.
- Thiếu quyền của một trường → bỏ trường đó khỏi
fieldshoặc ủy quyền lại tài khoản với quyền tương ứng.
Request
Địa chỉ
GET https://partner.quantri360.com/v1/tiktok_business/business/get/
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ả |
|---|---|---|---|---|---|
| fields | query | string[] | Không | ["display_name","username","followers_count","total_likes","videos_count","video_views","likes","daily_new_followers"] | Mảng JSON các trường cần lấy. Không gửi = chỉ display_name, profile_image. Trường hồ sơ trả ở data; trường số liệu ngày (video_views, unique_video_views, profile_views, likes, comments, shares, bio_link_clicks, phone_number_clicks, email_clicks, address_clicks, lead_submissions, app_download_clicks, daily_total_followers, daily_new_followers, daily_lost_followers, followers_count, audience_activity, engaged_audience) trả trong data.metrics[] theo từng ngày. KHÔNG gửi metrics / date (TikTok báo lỗi 40002). Quyền cần: xem cột mô tả từng trường ở phần phản hồi. |
| start_date | query | string | Không | 2026-10-15 | Ngày bắt đầu (YYYY-MM-DD, theo UTC, tính cả ngày này). Mặc định = hôm nay − 7 ngày. Lùi tối đa 60 ngày. |
| end_date | query | string | Không | 2026-10-22 | Ngày kết thúc (YYYY-MM-DD, UTC, tính cả ngày này). Mặc định = hôm qua. |
Ví dụ request
curl -s "https://partner.quantri360.com/v1/tiktok_business/business/get/?platform_shop_id=-000AbCdEfGhIjKlMnOpQrStUvWxYz012345&fields=%5B%22display_name%22%2C%22username%22%2C%22followers_count%22%2C%22total_likes%22%2C%22videos_count%22%2C%22video_views%22%2C%22likes%22%2C%22daily_new_followers%22%5D&start_date=2026-10-15&end_date=2026-10-22" \ -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/get/",
params={
"platform_shop_id": "-000AbCdEfGhIjKlMnOpQrStUvWxYz012345",
"fields": [
"display_name",
"username",
"followers_count",
"total_likes",
"videos_count",
"video_views",
"likes",
"daily_new_followers"
],
"start_date": "2026-10-15",
"end_date": "2026-10-22"
},
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/get/');
for (const [k, v] of Object.entries({"platform_shop_id":"-000AbCdEfGhIjKlMnOpQrStUvWxYz012345","fields":["display_name","username","followers_count","total_likes","videos_count","video_views","likes","daily_new_followers"],"start_date":"2026-10-15","end_date":"2026-10-22"})) 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/get/' . '?' . http_build_query(['platform_shop_id' => '-000AbCdEfGhIjKlMnOpQrStUvWxYz012345', 'fields' => '["display_name","username","followers_count","total_likes","videos_count","video_views","likes","daily_new_followers"]', 'start_date' => '2026-10-15', 'end_date' => '2026-10-22']); $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. | |
| display_name | string | thuong_hieu_mau | Tên hiển thị. Quyền: user.info.basic. |
| profile_image | string | Ảnh đại diện — link TẠM, hết hạn theo `x-expires`. Quyền: user.info.basic. | |
| username | string | thuonghieu.official | Tên người dùng (handle). Quyền: user.info.username. |
| bio_description | string | Tiểu sử. Quyền: user.info.profile. | |
| profile_deep_link | string | Link trang cá nhân. Quyền: user.info.profile. | |
| is_verified | bool | false | Có tích xanh. Quyền: user.info.profile. |
| is_business_account | bool | true | Là tài khoản doanh nghiệp đã xác minh. Quyền: user.account.type. |
| has_advanced_access | bool | true | Tài khoản có Advanced Access (mở thêm số liệu). Quyền: user.account.type. |
| followers_count | int | 13000 | Tổng người theo dõi hiện tại. Quyền: user.info.stats. |
| following_count | int | 19 | Số tài khoản đang theo dõi. Quyền: user.info.stats. |
| total_likes | int | Tổng lượt thích. Quyền: user.info.stats. | |
| videos_count | int | Số video công khai. Quyền: user.info.stats. | |
| metrics | object[] | Số liệu theo từng ngày trong khoảng ngày (chỉ có các trường số liệu đã yêu cầu). Trễ 24–48 giờ. Quyền: user.insights. | |
| date | string | 2026-10-20 | Ngày (YYYY-MM-DD, UTC). |
| video_views | int | 385 | Lượt xem video trong ngày. |
| unique_video_views | int | 13 | Số người xem (tiếp cận) trong ngày. |
| profile_views | int | 42 | Lượt xem trang cá nhân. |
| likes | int | ||
| comments | int | ||
| shares | int | ||
| daily_new_followers | int | 7 | Người theo dõi mới. |
| daily_lost_followers | int | Người bỏ theo dõi. | |
| daily_total_followers | int | Tăng ròng. | |
| followers_count | int | 12995 | Tổng người theo dõi tại ngày đó. |
| engaged_audience | int | 1 | Số người tương tác. |
| bio_link_clicks | int | Nhấn link trong tiểu sử. | |
| phone_number_clicks | int | ||
| email_clicks | int | ||
| address_clicks | int | ||
| lead_submissions | int | Khách để lại thông tin. | |
| app_download_clicks | int | ||
| audience_activity | object[] | Số người theo dõi đang hoạt động theo giờ (giờ UTC+0 — cộng 7 ra giờ Việt Nam). | |
| hour | string | 13 | 0–23. |
| count | int | 1123 | |
| audience_ages | object[] | Người theo dõi theo nhóm tuổi. Quyền: user.insights. | |
| age | string | 25-34 | 18-24 · 25-34 · 35-44 · 45-54 · 55+. |
| percentage | float | 0.43 | Tỉ lệ (0–1). |
| audience_genders | object[] | Người theo dõi theo giới tính. Quyền: user.insights. | |
| gender | string | Male | Male · Female · Other. |
| percentage | float | 0.5 | |
| audience_countries | object[] | Người theo dõi theo quốc gia (top, mã ISO 2 ký tự; `Others` = còn lại). Quyền: user.insights. | |
| country | string | VN | |
| percentage | float | 0.645 | |
| audience_cities | object[] | Người theo dõi theo thành phố (top). Quyền: user.insights. | |
| city_name | string | ||
| percentage | float |
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