Get the identity list
GET/identity/get/Via 360: GET https://partner.quantri360.com/v1/tiktok_business/identity/get/
Description
Danh tính (tài khoản TikTok / danh tính tùy chỉnh) dùng được để chạy quảng cáo trên tài khoản quảng cáo, kèm các quyền của từng danh tính (lấy video, chạy LIVE, quản lý tin nhắn, dùng Showcase…).
- Danh tính dùng cho chiến dịch GMV Max xem ở /gmv_max/identity/get/ (theo gian hàng).
Request
Endpoint
GET https://partner.quantri360.com/v1/tiktok_business/identity/get/
Authentication & shop
| Name | In | Type | Sample | Description |
|---|---|---|---|---|
| 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. |
Request parameters
| Name | In | Type | Required | Sample | Description |
|---|---|---|---|---|---|
| identity_type | query | string | No | TT_USER | CUSTOMIZED_USER (danh tính tùy chỉnh) · AUTH_CODE (qua mã ủy quyền bài) · TT_USER (tài khoản TikTok) · BC_AUTH_TT (tài khoản TikTok qua Business Center). Không gửi = mọi loại. Khi không gửi hoặc gửi BC_AUTH_TT, page_info trả toàn số 0 — đếm theo số dòng identity_list thay vì total_number. |
| identity_authorized_bc_id | query | string | No | Bắt buộc khi identity_type = BC_AUTH_TT: id Business Center gắn với danh tính. | |
| filtering | query | object | No | {"keyword":"thuonghieu"} | Chuỗi JSON {keyword} — tìm theo tên hiển thị, chỉ có tác dụng với CUSTOMIZED_USER hoặc khi không gửi identity_type. |
| page | query | int | No | 1 | Trang, mặc định 1. |
| page_size | query | int | No | 100 | Số dòng mỗi trang: 1–100, mặc định 20. |
Pagination
Lặp page = 1, 2, … tới khi page ≥ data.page_info.total_page.
Request examples
curl -s "https://partner.quantri360.com/v1/tiktok_business/identity/get/?platform_shop_id=7000000000000000001&identity_type=TT_USER&page_size=100" \ -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/identity/get/",
params={
"platform_shop_id": "7000000000000000001",
"identity_type": "TT_USER",
"page_size": 100
},
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/identity/get/');
for (const [k, v] of Object.entries({"platform_shop_id":"7000000000000000001","identity_type":"TT_USER","page_size":100})) 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/identity/get/' . '?' . http_build_query(['platform_shop_id' => '7000000000000000001', 'identity_type' => 'TT_USER', 'page_size' => 100]); $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
Response fields (as returned by TikTok Business)
| Name | Type | Sample | Description |
|---|---|---|---|
| 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. | |
| identity_list | object[] | Danh tính. | |
| identity_id | string | 7000000000000000002 | Id danh tính. |
| identity_type | string | TT_USER | Loại danh tính. |
| identity_authorized_bc_id | string | Business Center gắn với danh tính (loại `BC_AUTH_TT`). | |
| display_name | string | Thương hiệu mẫu | Tên hiển thị. |
| username | string | thuonghieu.official | Tên người dùng. |
| profile_image | string | Ảnh đại diện. | |
| available_status | string | AVAILABLE | Chỉ `TT_USER` / `BC_AUTH_TT`: `AVAILABLE` · `NO_VALID_BIND_ACCOUNT` · `SCOPE_UNAVAILABLE` · `IS_PRIVATE_ACCOUNT` · `NOT_BUSINESS_ACCOUNT`. |
| can_pull_video | bool | true | Lấy được video của tài khoản. |
| can_push_video | bool | true | Tạo / sửa được video. |
| can_use_live_ads | bool | false | Chạy được quảng cáo LIVE. |
| can_manage_message | bool | false | Quản lý được tin nhắn. |
| can_use_showcase | bool | false | Dùng được sản phẩm từ Showcase. |
| can_use_series | bool | false | Dùng được TikTok Series. |
| ads_only_mode | bool | Chỉ `BC_AUTH_TT`: `true` = bài chỉ hiển thị qua quảng cáo. | |
| is_gpppa | bool | false | `true` = tài khoản chính phủ / chính trị — không dùng được cho Spark Ads. |
| page_info | object | Phân trang. | |
| page | int | 1 | Trang hiện tại. |
| page_size | int | 100 | Số dòng mỗi trang. |
| total_number | int | 35 | Tổng số dòng. |
| total_page | int | 1 | Tổng số trang. |
Get started
- Sign up for Partner
- Enable a data type of the Ads (Marketing API) group on the platform page
- Create an API key (tick the TikTok Business channel)
- Call it as in the examples above