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_ltkhô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ên | Vị trí | Kiểu | Mẫu | Mô tả |
|---|---|---|---|---|
| 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 | 100001 | Gian 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ên | Vị trí | Kiểu | Bắt buộc | Mẫu | Mô tả |
|---|---|---|---|---|---|
| start_date_ge | query | string | Có | 2026-10-15 | Từ ngày (YYYY-MM-DD, theo múi giờ gian hàng, tính cả ngày này). |
| end_date_lt | query | string | Có | 2026-10-22 | Đến TRƯỚC ngày (YYYY-MM-DD, không tính ngày này). |
| granularity | query | string | Không | 1D | ALL (mặc định) = gộp cả kỳ · 1D = từng ngày. |
| currency | query | string | Không | LOCAL | LOCAL (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¤cy=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ên | Kiểu | Mẫu | Mô tả |
|---|---|---|---|
| code | int | 0 | 0 = thành công; khác 0 xem message (105001–105003 = token, 360 đã tự làm mới một lần). |
| message | string | Success | Thông điệp của TikTok. |
| request_id | string | 2025101900000000000000000000 | Mã request TikTok. |
| data | object | Dữ liệu. | |
| latest_available_date | string | 2026-10-27 | Ngày gần nhất đã có số liệu. |
| performance | object | ||
| intervals | object[] | Mỗi ngày (granularity 1D) hoặc một dòng (ALL). | |
| start_date | string | 2026-10-20 | |
| end_date | string | 2026-10-21 | (không tính ngày này) |
| sales | object | Bán hàng — tiền dạng {amount, currency}. | |
| gmv | object | GMV. | |
| gmv_with_tiktok_co_funding | object | GMV cộng phần sàn trợ giá. | |
| gmv_with_tax | object | GMV gồm thuế (VN thường 0). | |
| orders_count | int | 12 | Số đơn. |
| sku_orders_count | int | 14 | Số đơn theo SKU. |
| items_sold | int | 15 | Số sản phẩm bán. |
| customers_count | int | 11 | Số khách mua. |
| avg_order_value | object | Giá trị đơn trung bình. | |
| avg_sku_order_value | object | ||
| refunds | object | Tiền hoàn. | |
| cancellations_and_returns | int | 0 | Số đơn hủy + trả. |
| shipping_fees | object | ||
| tax | object | ||
| live_gmv | object | GMV từ LIVE; có thêm `live_attributed_gmv`, `live_indirect_gmv` và bản tách `seller_live_*` / `creator_live_*`. | |
| video_gmv | object | GMV từ video; có thêm `video_attributed_gmv`, `video_indirect_gmv` và bản tách `seller_video_*` / `creator_video_*`. | |
| product_card_attributed_gmv | object | GMV từ thẻ sản phẩm. | |
| traffic | object | Lưu lượng truy cập. | |
| avg_page_views | int | 500 | Lượt xem trang. |
| avg_visitors | int | 200 | Khách truy cập. |
| product_impressions | int | 10000 | Lượt hiển thị sản phẩm. |
| unique_product_impressions | int | 3000 | Số người thấy sản phẩm. |
| product_clicks | int | 400 | Lượt nhấp sản phẩm. |
| unique_clicks | int | 150 | Số người nhấp. |
| avg_conversation_rate | string | 0.0100 | Tỉ lệ chuyển đổi (0–1, chuỗi; 0.0100 = 1%). |
| breakdowns | object | GMV theo nguồn. | |
| content_breakdown | object[] | Theo {channel `SELLER`|`CREATOR`, content_type `LIVE`|`VIDEO`}: gmv, indirect_gmv. | |
| seller_product_card_gmv | object | Thẻ sản phẩm của shop. | |
| affiliate_product_card_attributed_gmv | object | Thẻ sản phẩm qua affiliate. | |
| shop_tab_and_search | object | {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
- Đăng ký tài khoản Partner
- Mở loại dữ liệu thuộc nhóm Đơn hàng ở trang nền tảng
- Tạo API key (tick kênh TikTok Shop)
- Gọi theo ví dụ ở trên