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

Hiệu quả bán hàng + lưu lượng gian hàng — API TikTok Shop

tiktok.analytics.202609.shop.performance · 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.

tiktok.analytics.202609.shop.performance

GET/analytics/202609/shop/performanceGọi qua 360: GET https://partner.quantri360.com/v1/tiktok/analytics/202609/shop/performance
Mô tả API

Hiệu quả bán hàng của cả gian hàng theo ngày (hoặc gộp cả kỳ): GMV, đơn, khách, hoàn / hủy, GMV tách theo LIVE / video / thẻ sản phẩm (của shop và creator), lưu lượng truy cập (lượt xem trang, khách, hiển thị / nhấp sản phẩm, tỉ lệ chuyển đổi).

  • end_date_lt không tính ngày đó — muốn gồm ngày X thì gửi X + 1.
  • Số liệu trễ ~1 ngày: xem latest_available_date.
  • Tiền dạng {amount, currency}, amount là chuỗi số.
  • Một lần gọi có đủ tổng quan bán hàng, số liệu theo ngày (granularity=1D) và lưu lượng truy cập — không cần API riêng cho từng phần.
  • Cùng tham số và kết quả ở các bản /analytics/202405/shop/performance và /analytics/202509/shop/performance.

Request

Địa chỉ

GET https://partner.quantri360.com/v1/tiktok/analytics/202609/shop/performance

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_idquerystring100001Gian hàng (lấy ở GET /v1/platforms → shops[].platform_shop_id). BẮT BUỘC khi brand có > 1 gian hàng trên nền tảng; 360 bỏ tham số này trước khi chuyển tiếp.

Tham số request

TênVị tríKiểuBắt buộcMẫuMô tả
start_date_gequerystringCó2026-10-15Từ ngày (YYYY-MM-DD, theo múi giờ gian hàng, tính cả ngày này).
end_date_ltquerystringCó2026-10-22Đến TRƯỚC ngày (YYYY-MM-DD, không tính ngày này).
granularityquerystringKhông1DALL (mặc định) = gộp cả kỳ · 1D = từng ngày.
currencyquerystringKhôngLOCALLOCAL (tiền gian hàng, mặc định) · USD.

Ví dụ request

curl -s "https://partner.quantri360.com/v1/tiktok/analytics/202609/shop/performance?platform_shop_id=7494000000000000000&start_date_ge=2026-10-20&end_date_lt=2026-10-27&granularity=1D&currency=LOCAL" \
  -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/analytics/202609/shop/performance",
    params={
        "platform_shop_id": "7494000000000000000",
        "start_date_ge": "2026-10-20",
        "end_date_lt": "2026-10-27",
        "granularity": "1D",
        "currency": "LOCAL"
    },
    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/analytics/202609/shop/performance');
for (const [k, v] of Object.entries({"platform_shop_id":"7494000000000000000","start_date_ge":"2026-10-20","end_date_lt":"2026-10-27","granularity":"1D","currency":"LOCAL"})) 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/analytics/202609/shop/performance' . '?' . http_build_query(['platform_shop_id' => '7494000000000000000', 'start_date_ge' => '2026-10-20', 'end_date_lt' => '2026-10-27', 'granularity' => '1D', 'currency' => 'LOCAL']);
$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 Shop)

TênKiểuMẫuMô tả
codeint00 = thành công; khác 0 xem message (105001–105003 = token, 360 đã tự làm mới một lần).
messagestringSuccessThông điệp của TikTok.
request_idstring2025101900000000000000000000Mã request TikTok.
dataobjectDữ liệu.
latest_available_datestring2026-10-27Ngày gần nhất đã có số liệu.
performanceobject
intervalsobject[]Mỗi ngày (granularity 1D) hoặc một dòng (ALL).
start_datestring2026-10-20
end_datestring2026-10-21(không tính ngày này)
salesobjectBán hàng — tiền dạng {amount, currency}.
gmvobjectGMV.
gmv_with_tiktok_co_fundingobjectGMV cộng phần sàn trợ giá.
gmv_with_taxobjectGMV gồm thuế (VN thường 0).
orders_countint12Số đơn.
sku_orders_countint14Số đơn theo SKU.
items_soldint15Số sản phẩm bán.
customers_countint11Số khách mua.
avg_order_valueobjectGiá trị đơn trung bình.
avg_sku_order_valueobject
refundsobjectTiền hoàn.
cancellations_and_returnsint0Số đơn hủy + trả.
shipping_feesobject
taxobject
live_gmvobjectGMV từ LIVE; có thêm `live_attributed_gmv`, `live_indirect_gmv` và bản tách `seller_live_*` / `creator_live_*`.
video_gmvobjectGMV từ video; có thêm `video_attributed_gmv`, `video_indirect_gmv` và bản tách `seller_video_*` / `creator_video_*`.
product_card_attributed_gmvobjectGMV từ thẻ sản phẩm.
trafficobjectLưu lượng truy cập.
avg_page_viewsint500Lượt xem trang.
avg_visitorsint200Khách truy cập.
product_impressionsint10000Lượt hiển thị sản phẩm.
unique_product_impressionsint3000Số người thấy sản phẩm.
product_clicksint400Lượt nhấp sản phẩm.
unique_clicksint150Số người nhấp.
avg_conversation_ratestring0.0100Tỉ lệ chuyển đổi (0–1, chuỗi; 0.0100 = 1%).
breakdownsobjectGMV theo nguồn.
content_breakdownobject[]Theo {channel `SELLER`|`CREATOR`, content_type `LIVE`|`VIDEO`}: gmv, indirect_gmv.
seller_product_card_gmvobjectThẻ sản phẩm của shop.
affiliate_product_card_attributed_gmvobjectThẻ sản phẩm qua affiliate.
shop_tab_and_searchobject{shop_tab_attributed, search_attributed, others}.

Mẫu phản hồi

{"code":0,"data":{"latest_available_date":"2024-04-07","performance":{"intervals":[{"breakdowns":{"affiliate_product_card_attributed_gmv":{"amount":"2363.83","currency":"USD"},"content_breakdown":[{"channel":"CREATOR","content_type":"LIVE","gmv":{"amount":"0.00","currency":"USD"},"indirect_gmv":{"amount":"0.00","currency":"USD"}}],"seller_product_card_gmv":{"amount":"2363.83","currency":"USD"},"shop_tab_and_search":{"others":{"amount":"0.00","currency":"USD"},"search_attributed":{"amount":"1484.40","currency":"USD"},"shop_tab_attributed":{"amount":"879.43","currency":"USD"}}},"end_date":"2024-04-08","sales":{"avg_order_value":{"amount":"2.29","currency":"USD"},"avg_sku_order_value":{"amount":"2.29","currency":"USD"},"cancellations_and_returns":0,"creator_live_attributed_gmv":{"amount":"0.00","currency":"USD"},"creator_live_gmv":{"amount":"0.00","currency":"USD"},"creator_live_indirect_gmv":{"amount":"0.00","currency":"USD"},"creator_video_attributed_gmv":{"amount":"0.00","currency":"USD"},"creator_video_gmv":{"amount":"0.00","currency":"USD"},"creator_video_indirect_gmv":{"amount":"0.00","currency":"USD"},"customers_count":7,"gmv":{"amount":"29.71","currency":"USD"},"gmv_with_tax":{"amount":"0.00","currency":"USD"},"gmv_with_tiktok_co_funding":{"amount":"0.00","currency":"USD"},"items_sold":13,"live_attributed_gmv":{"amount":"0.00","currency":"USD"},"live_gmv":{"amount":"0.00","currency":"USD"},"live_indirect_gmv":{"amount":"0.00","currency":"USD"},"orders_count":13,"product_card_attributed_gmv":{"amount":"0.00","currency":"USD"},"refunds":{"amount":"0.00","currency":"USD"},"seller_live_attributed_gmv":{"amount":"0.00","currency":"USD"},"seller_live_gmv":{"amount":"0.00","currency":"USD"},"seller_live_indirect_gmv":{"amount":"0.00","currency":"USD"},"seller_video_attributed_gmv":{"amount":"0.00","currency":"USD"},"seller_video_gmv":{"amount":"0.00","currency":"USD"},"seller_video_indirect_gmv":{"amount":"0.00","currency":"USD"},"shipping_fees":{"amount":"0.00","currency":"USD"},"sku_orders_count":13,"tax":{"amount":"0.00","currency":"USD"},"video_attributed_gmv":{"amount":"0.00","currency":"USD"},"video_gmv":{"amount":"0.00","currency":"USD"},"video_indirect_gmv":{"amount":"0.00","currency":"USD"}},"start_date":"2024-04-01","traffic":{"avg_conversation_rate":"0.3342","avg_page_views":56234,"avg_visitors":3433,"product_clicks":12654,"product_impressions":86234,"unique_clicks":8342,"unique_product_impressions":52314}}]}},"message":"Success","request_id":"202203070749000101890810281E8C70B7"}

Bắt đầu dùng

  1. Đăng ký tài khoản Partner
  2. Mở loại dữ liệu thuộc nhóm Đơn hàng ở trang nền tảng
  3. Tạo API key (tick kênh TikTok Shop)
  4. Gọi theo ví dụ ở trên