Get ad account details
GET/advertiser/info/Via 360: GET https://partner.quantri360.com/v1/tiktok_business/advertiser/info/
Description
Thông tin tài khoản quảng cáo đã nối: tên, trạng thái, công ty, tiền tệ, múi giờ, quốc gia, số dư tổng, ngày tạo… Dùng để hiển thị tài khoản và đổi số liệu báo cáo theo đúng tiền tệ / múi giờ của tài khoản.
- Chỉ gửi id tài khoản quảng cáo đã nối với 360 trong không gian của bạn (danh sách ở
GET /v1/platforms). - Lấy
currencyvàtimezonemột lần khi bắt đầu — số tiền ở các API báo cáo / chiến dịch tính theo tiền tệ này, ngày theo múi giờ này.
Request
Endpoint
GET https://partner.quantri360.com/v1/tiktok_business/advertiser/info/
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 |
|---|---|---|---|---|---|
| advertiser_ids | query | string[] | Yes | ["7000000000000000001"] | Mảng JSON id tài khoản quảng cáo cần xem — gửi id tài khoản đã nối với 360 (= platform_shop_id). 360 KHÔNG tự điền tham số này. |
| fields | query | string[] | No | ["advertiser_id","name","status","currency","timezone","display_timezone","balance","company","country"] | Mảng JSON các trường cần lấy. Không gửi = mọi trường trừ company_name_editable, can_use_custom_identity, ads_only_mode (ba trường này phải xin đích danh). Chọn được: advertiser_id, name, status, role, rejection_reason, company, company_name_editable, description, industry, address, country, currency, timezone, display_timezone, language, contacter, email, cellphone_number, telephone_number, license_no, license_url, balance, create_time, owner_bc_id, can_use_custom_identity, ads_only_mode. |
Request examples
curl -s "https://partner.quantri360.com/v1/tiktok_business/advertiser/info/?platform_shop_id=7000000000000000001&advertiser_ids=%5B%227000000000000000001%22%5D&fields=%5B%22advertiser_id%22%2C%22name%22%2C%22status%22%2C%22currency%22%2C%22timezone%22%2C%22balance%22%5D" \ -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/advertiser/info/",
params={
"platform_shop_id": "7000000000000000001",
"advertiser_ids": [
"7000000000000000001"
],
"fields": [
"advertiser_id",
"name",
"status",
"currency",
"timezone",
"balance"
]
},
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/advertiser/info/');
for (const [k, v] of Object.entries({"platform_shop_id":"7000000000000000001","advertiser_ids":["7000000000000000001"],"fields":["advertiser_id","name","status","currency","timezone","balance"]})) 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/advertiser/info/' . '?' . http_build_query(['platform_shop_id' => '7000000000000000001', 'advertiser_ids' => '["7000000000000000001"]', 'fields' => '["advertiser_id","name","status","currency","timezone","balance"]']); $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. | |
| list | object[] | Mỗi tài khoản quảng cáo một dòng (chỉ có các trường đã yêu cầu). | |
| advertiser_id | string | 7000000000000000001 | Id tài khoản quảng cáo. |
| name | string | Thương hiệu mẫu - TKQC 01 | Tên tài khoản. |
| status | string | STATUS_ENABLE | Trạng thái tài khoản (vd `STATUS_ENABLE` = đang hoạt động). |
| role | string | ROLE_ADVERTISER | Vai trò tài khoản. |
| rejection_reason | string | Lý do bị từ chối (nếu có). | |
| company | string | Công ty TNHH Mẫu | Tên công ty. |
| company_name_editable | bool | false | Có đổi được tên công ty qua API không (tài khoản do nhân viên TikTok quản lý luôn `false`). |
| description | string | Mô tả thương hiệu. | |
| industry | string | 290303 | Mã ngành. |
| address | string | Địa chỉ. | |
| country | string | VN | Nơi đăng ký (mã quốc gia 2 chữ cái). |
| currency | string | VND | Tiền tệ của tài khoản (ISO 4217) — mọi số tiền của tài khoản tính theo tiền tệ này. |
| timezone | string | Asia/Ho_Chi_Minh | Múi giờ tài khoản (độ lệch GMT hoặc tên vùng, vd `Etc/GMT+7`). |
| display_timezone | string | Asia/Ho_Chi_Minh | Tên múi giờ dạng Vùng/Thành phố. |
| language | string | vi | Ngôn ngữ. |
| advertiser_account_type | string | AUCTION | `AUCTION` = đấu giá · `RESERVATION` = đặt trước. |
| contacter | string | Ng******** | Người liên hệ (đã che). |
| string | l***@*** | Email liên hệ (đã che). | |
| cellphone_number | string | Số di động (đã che). | |
| telephone_number | string | Số cố định (đã che). | |
| license_no | string | Số giấy phép kinh doanh. | |
| license_url | string | Link xem giấy phép — hạn 1 giờ. | |
| balance | float | 5325000 | Tổng số dư (theo `currency`), không tách tiền mặt / voucher / số dư khả dụng. |
| create_time | int | 1710740064 | Thời điểm tạo tài khoản, Unix giây. |
| owner_bc_id | string | Id Business Center sở hữu tài khoản — chỉ có khi người ủy quyền là quản trị của Business Center đó. | |
| can_use_custom_identity | bool | false | Tài khoản còn dùng được danh tính tùy chỉnh để tạo quảng cáo không. |
| ads_only_mode | bool | false | `true` = Spark Ads của tài khoản bắt buộc ở chế độ "Chỉ hiển thị qua quảng cáo". |
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