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

Lấy dữ liệu hồ sơ tài khoản TikTok — API TikTok Business

Get profile data of 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 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 fields hoặ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ê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ả
fieldsquerystring[]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_datequerystringKhông2026-10-15Ngà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_datequerystringKhông2026-10-22Ngà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ê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.
display_namestringthuong_hieu_mauTên hiển thị. Quyền: user.info.basic.
profile_imagestringẢnh đại diện — link TẠM, hết hạn theo `x-expires`. Quyền: user.info.basic.
usernamestringthuonghieu.officialTên người dùng (handle). Quyền: user.info.username.
bio_descriptionstringTiểu sử. Quyền: user.info.profile.
profile_deep_linkstringLink trang cá nhân. Quyền: user.info.profile.
is_verifiedboolfalseCó tích xanh. Quyền: user.info.profile.
is_business_accountbooltrueLà tài khoản doanh nghiệp đã xác minh. Quyền: user.account.type.
has_advanced_accessbooltrueTài khoản có Advanced Access (mở thêm số liệu). Quyền: user.account.type.
followers_countint13000Tổng người theo dõi hiện tại. Quyền: user.info.stats.
following_countint19Số tài khoản đang theo dõi. Quyền: user.info.stats.
total_likesintTổng lượt thích. Quyền: user.info.stats.
videos_countintSố video công khai. Quyền: user.info.stats.
metricsobject[]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.
datestring2026-10-20Ngày (YYYY-MM-DD, UTC).
video_viewsint385Lượt xem video trong ngày.
unique_video_viewsint13Số người xem (tiếp cận) trong ngày.
profile_viewsint42Lượt xem trang cá nhân.
likesint
commentsint
sharesint
daily_new_followersint7Người theo dõi mới.
daily_lost_followersintNgười bỏ theo dõi.
daily_total_followersintTăng ròng.
followers_countint12995Tổng người theo dõi tại ngày đó.
engaged_audienceint1Số người tương tác.
bio_link_clicksintNhấn link trong tiểu sử.
phone_number_clicksint
email_clicksint
address_clicksint
lead_submissionsintKhách để lại thông tin.
app_download_clicksint
audience_activityobject[]Số người theo dõi đang hoạt động theo giờ (giờ UTC+0 — cộng 7 ra giờ Việt Nam).
hourstring130–23.
countint1123
audience_agesobject[]Người theo dõi theo nhóm tuổi. Quyền: user.insights.
agestring25-3418-24 · 25-34 · 35-44 · 45-54 · 55+.
percentagefloat0.43Tỉ lệ (0–1).
audience_gendersobject[]Người theo dõi theo giới tính. Quyền: user.insights.
genderstringMaleMale · Female · Other.
percentagefloat0.5
audience_countriesobject[]Người theo dõi theo quốc gia (top, mã ISO 2 ký tự; `Others` = còn lại). Quyền: user.insights.
countrystringVN
percentagefloat0.645
audience_citiesobject[]Người theo dõi theo thành phố (top). Quyền: user.insights.
city_namestring
percentagefloat

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