VI | EN
Message us on Messenger
Developer resources

Get ad account details — TikTok Business API

Get ad account details · call it through Quantri360 with one API key for your own accounts / assets that you connected and authorized — 360 handles request signing and refreshing the authorization you granted.

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 currency và timezone mộ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

NameInTypeSampleDescription
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.

Request parameters

NameInTypeRequiredSampleDescription
advertiser_idsquerystring[]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.
fieldsquerystring[]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)

NameTypeSampleDescription
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.
listobject[]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_idstring7000000000000000001Id tài khoản quảng cáo.
namestringThương hiệu mẫu - TKQC 01Tên tài khoản.
statusstringSTATUS_ENABLETrạng thái tài khoản (vd `STATUS_ENABLE` = đang hoạt động).
rolestringROLE_ADVERTISERVai trò tài khoản.
rejection_reasonstringLý do bị từ chối (nếu có).
companystringCông ty TNHH MẫuTên công ty.
company_name_editableboolfalseCó đổ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`).
descriptionstringMô tả thương hiệu.
industrystring290303Mã ngành.
addressstringĐịa chỉ.
countrystringVNNơi đăng ký (mã quốc gia 2 chữ cái).
currencystringVNDTiề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.
timezonestringAsia/Ho_Chi_MinhMúi giờ tài khoản (độ lệch GMT hoặc tên vùng, vd `Etc/GMT+7`).
display_timezonestringAsia/Ho_Chi_MinhTên múi giờ dạng Vùng/Thành phố.
languagestringviNgôn ngữ.
advertiser_account_typestringAUCTION`AUCTION` = đấu giá · `RESERVATION` = đặt trước.
contacterstringNg********Người liên hệ (đã che).
emailstringl***@***Email liên hệ (đã che).
cellphone_numberstringSố di động (đã che).
telephone_numberstringSố cố định (đã che).
license_nostringSố giấy phép kinh doanh.
license_urlstringLink xem giấy phép — hạn 1 giờ.
balancefloat5325000Tổng số dư (theo `currency`), không tách tiền mặt / voucher / số dư khả dụng.
create_timeint1710740064Thời điểm tạo tài khoản, Unix giây.
owner_bc_idstringId 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_identityboolfalseTà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_modeboolfalse`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

  1. Sign up for Partner
  2. Enable a data type of the Ads (Marketing API) group on the platform page
  3. Create an API key (tick the TikTok Business channel)
  4. Call it as in the examples above