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

Tìm kiếm creator TTO — API TikTok Business

Discover TTO creators · 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.

Discover TTO creators

GET/tto/tcm/creator/discover/Gọi qua 360: GET https://partner.quantri360.com/v1/tiktok_business/tto/tcm/creator/discover/
Mô tả API

Tìm creator trên TikTok One Creator Marketplace theo quốc gia, nhãn, số người theo dõi, lượt xem, tỉ lệ tương tác, giá khởi điểm, chân dung người theo dõi, từ khóa… — bước đầu khi chọn KOC / creator để hợp tác.

  • Gọi bằng TÀI KHOẢN QUẢNG CÁO đã nối (platform_shop_id = id tài khoản quảng cáo), không phải tài khoản TikTok. Chưa biết tto_tcm_account_id của bạn → liên hệ 360.
  • Kết quả chỉ có thông tin cơ bản — xem chân dung khán giả, giá khởi điểm, nhãn ở /tto/tcm/creator/public/ theo handle_name.

Request

Địa chỉ

GET https://partner.quantri360.com/v1/tiktok_business/tto/tcm/creator/discover/

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ả
tto_tcm_account_idquerystringCó7300000000000000001Id tài khoản TikTok One Creator Marketplace mà tài khoản quảng cáo đã nối được quyền truy cập. Chưa biết id của bạn → liên hệ 360.
country_codesquerystring[]Có["VN"]Mảng JSON mã quốc gia 2 chữ cái của creator (vd ["VN"]). Gửi nhiều mã thì các mã phải cùng một nhóm: US riêng · châu Âu (DE, ES, FR, GB, IT) · nhóm còn lại (AE, AR, AU, BR, CA, CO, EG, ID, IL, JP, KR, MX, MY, PH, SA, SG, TH, TR, TW, VN).
state_provincesquerystring[]KhôngChỉ khi country_codes = ["US"]: lọc theo bang của Mỹ.
keyword_searchquerystringKhôngthời trangTừ khóa tìm creator, khớp gần đúng, tối đa 100 ký tự.
content_label_idsquerystring[]KhôngMảng JSON id nhãn NỘI DUNG (tối đa 100) — lấy ở /tto/tcm/category/label/ với label_type = SEARCH, mục content_labels.
industry_label_idsquerystring[]KhôngMảng JSON id nhãn NGÀNH (tối đa 100) — lấy ở /tto/tcm/category/label/ với label_type = SEARCH, mục industry_labels.
min_followersqueryintKhông10000Người theo dõi tối thiểu, mặc định 0.
max_followersqueryintKhôngNgười theo dõi tối đa.
min_avg_viewsqueryintKhôngLượt xem trung bình tối thiểu, mặc định 0.
max_avg_viewsqueryintKhôngLượt xem trung bình tối đa.
min_median_viewsqueryintKhôngLượt xem trung vị tối thiểu (lượt xem "điển hình" của các video gần đây), mặc định 0.
max_median_viewsqueryintKhôngLượt xem trung vị tối đa.
min_engagement_ratequeryfloatKhông0.02Tỉ lệ tương tác tối thiểu (0–1; = (bình luận + thích + chia sẻ) / lượt xem), mặc định 0.
max_engagement_ratequeryfloatKhôngTỉ lệ tương tác tối đa (0–1).
min_creator_pricequeryfloatKhôngGiá khởi điểm tối thiểu, mặc định 0.
max_creator_pricequeryfloatKhôngGiá khởi điểm tối đa.
creator_price_currencyquerystringKhôngUSDTiền tệ của hai bộ lọc giá — hiện chỉ USD (mặc định).
languagesquerystring[]Không["vi"]Mảng JSON ngôn ngữ: ar · de · en · es · fr · id · it · ja · ko · ms · pt · th · tl · tr · vi. Không gửi = mọi ngôn ngữ.
follower_country_codesquerystring[]Không["VN"]Mảng JSON quốc gia của người theo dõi: AE · AU · BR · CA · DE · EG · ES · FR · GB · ID · IL · IT · JP · KR · MY · PH · RU · SA · SG · TH · TR · TW · US · VN.
follower_gender_ratioquerystringKhôngFEMALE_60Tỉ lệ giới tính người theo dõi: FEMALE_50 / FEMALE_60 / FEMALE_70 (nữ trên 50 / 60 / 70%) · MALE_50 / MALE_60 / MALE_70.
follower_agequerystringKhông25-34Nhóm tuổi chiếm đa số trong người theo dõi: 18-24 · 25-34 · 35-44 · 45-54 · 55+.
highly_responsivequeryboolKhôngtrue = chỉ creator thường trả lời lời mời nhanh.
highly_activequeryboolKhôngtrue = chỉ creator hay vào TikTok One gần đây.
high_potential_to_drive_salesqueryboolKhôngtrue = chỉ creator mạnh về ra đơn.
high_quality_content_creatorqueryboolKhôngtrue = chỉ creator nội dung chất lượng cao (không áp dụng ở châu Âu).
sort_fieldquerystringKhôngFOLLOWERSRELEVANCE (mặc định) · FOLLOWERS · MEDIAN_VIEWS · ENGAGEMENT_RATE.
sort_orderquerystringKhôngDESCDESC (mặc định) · ASC.
pagequeryintKhông1Trang, từ 1.
page_sizequeryintKhông50Số creator mỗi trang: 1–200, mặc định 24.

Phân trang

Lặp page = 1, 2, … tới khi page ≥ data.page_info.total_page.

Ví dụ request

curl -s "https://partner.quantri360.com/v1/tiktok_business/tto/tcm/creator/discover/?platform_shop_id=7000000000000000001&tto_tcm_account_id=7300000000000000001&country_codes=%5B%22VN%22%5D&min_followers=10000&sort_field=FOLLOWERS&page_size=50" \
  -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/tto/tcm/creator/discover/",
    params={
        "platform_shop_id": "7000000000000000001",
        "tto_tcm_account_id": "7300000000000000001",
        "country_codes": [
            "VN"
        ],
        "min_followers": 10000,
        "sort_field": "FOLLOWERS",
        "page_size": 50
    },
    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/tto/tcm/creator/discover/');
for (const [k, v] of Object.entries({"platform_shop_id":"7000000000000000001","tto_tcm_account_id":"7300000000000000001","country_codes":["VN"],"min_followers":10000,"sort_field":"FOLLOWERS","page_size":50})) 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/tto/tcm/creator/discover/' . '?' . http_build_query(['platform_shop_id' => '7000000000000000001', 'tto_tcm_account_id' => '7300000000000000001', 'country_codes' => '["VN"]', 'min_followers' => 10000, 'sort_field' => 'FOLLOWERS', 'page_size' => 50]);
$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.
creatorsobject[]Creator tìm được.
handle_namestringcreator_mauTên người dùng (không có @) — dùng cho /tto/tcm/creator/public/.
display_namestringCreator mẫuTên hiển thị.
profile_imagestringẢnh đại diện — link TẠM (hạn khoảng 7 ngày, mốc hết hạn ở `x-expires`); hết hạn thì gọi lại để lấy link mới.
followers_countint125000Người theo dõi.
following_countint300Đang theo dõi.
likes_countint2500000Tổng lượt thích.
videos_countint420Số video công khai.
page_infoobjectPhân trang.
pageint1Trang hiện tại.
page_sizeint100Số dòng mỗi trang.
total_numberint35Tổng số dòng.
total_pageint1Tổng số trang.

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