tiktok.analytics.202510.shop_lives.live_id.performance_per_minutes
GET/analytics/202510/shop_lives/{live_id}/performance_per_minutesVia 360: GET https://partner.quantri360.com/v1/tiktok/analytics/202510/shop_lives/{live_id}/performance_per_minutes
Description
Hiệu quả của MỘT phiên LIVE theo từng phút: người xem, lượt hiển thị, nhấp sản phẩm, tương tác, đơn và GMV mỗi phút + tổng phiên — dùng để tìm khung phút chốt đơn tốt / rơi người xem, đánh giá kịch bản live.
- Gọi qua /v1/tiktok/analytics/202510/shop_lives/{live_id}/performance_per_minutes với Authorization: Bearer <key>; dùng platform_shop_id khi có nhiều shop. 360 tự gắn app_key, shop_cipher, sign và access_token.
- API chỉ đọc; code = 0 mới là thành công.
- Chỉ có dữ liệu sau khi phiên kết thúc, và chỉ phiên của tài khoản chính thức / tài khoản marketing của shop.
- Tỉ lệ là CHUỖI số thập phân (0.10 = 10%), không phải phần trăm.
ctrtính trên lượt xem nên có thể > 1. - Đã gặp thật:
overall.gmvtrả "80.31" kèmcurrency"VND" trong khi phiên bán 2.085.826đ — con số khớp giá trị quy ra USD dù nhãn là VND. Lấy GMV phiên ở /analytics/202509/shop_lives/performance hoặc cộngintervals[].sales.gmv. - GMV dạng
{amount, currency}, amount là chuỗi có 2 chữ số lẻ kể cả VND.
Request
Endpoint
GET https://partner.quantri360.com/v1/tiktok/analytics/202510/shop_lives/{live_id}/performance_per_minutes
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 | 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. |
Request parameters
| Name | In | Type | Required | Sample | Description |
|---|---|---|---|---|---|
| live_id | path | string | Yes | 7693774836657277717 | Mã phiên LIVE — id của GET /analytics/202509/shop_lives/performance (live_stream_sessions[].id). |
| currency | query | string | No | LOCAL | LOCAL (tiền gian hàng, mặc định) · USD. |
| page_token | query | string | No | next_page_token của trang trước. |
Pagination
Mỗi trang tối đa 100 phút (không chỉnh được — page_size bị bỏ qua). Lặp khi data.next_page_token khác rỗng, thêm query page_token.
Request examples
curl -s "https://partner.quantri360.com/v1/tiktok/analytics/202510/shop_lives/7693774836657277717/performance_per_minutes?platform_shop_id=7494000000000000000¤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/202510/shop_lives/7693774836657277717/performance_per_minutes",
params={
"platform_shop_id": "7494000000000000000",
"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/202510/shop_lives/7693774836657277717/performance_per_minutes');
for (const [k, v] of Object.entries({"platform_shop_id":"7494000000000000000","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/202510/shop_lives/7693774836657277717/performance_per_minutes' . '?' . http_build_query(['platform_shop_id' => '7494000000000000000', '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
Response fields (as returned by TikTok Shop)
| Name | Type | Sample | Description |
|---|---|---|---|
| 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 | DEMO_REQUEST_A_01 | Mã request TikTok. |
| data | object | Dữ liệu. | |
| total_count | number | 1 | Tổng số phút. |
| next_page_token | string | Tiếp theo trang con trỏ. | |
| performance | object | Hiệu quả. | |
| overall | object | Tổng phiên (lặp lại ở mọi trang). | |
| live_title | string | Minh họa | Live tiêu đề. |
| start_time | number | 1793491200 | Unix giây. |
| end_time | number | 1793577600 | Kết thúc thời điểm. |
| duration | number | 1 | Giây. |
| gmv | object | {amount, currency} — xem lưu ý. | |
| amount | string | 10000 | Số tiền. |
| currency | string | VND | Tiền tệ. |
| items_sold | number | 1 | Items sold. |
| unique_viewers | number | 1 | Người xem duy nhất. |
| impressions | number | 1 | Lượt LIVE được hiển thị. |
| intervals | object[] | Mỗi phút một phần tử. | |
| start_time | number | 1793491200 | Unix giây. |
| end_time | number | 1793577600 | Kết thúc thời điểm. |
| sales | object | Doanh số. | |
| gmv | object | {amount, currency}. | |
| amount | string | 10000 | Số tiền. |
| currency | string | VND | Tiền tệ. |
| items_sold | number | 1 | Items sold. |
| customers | number | 1 | Khách hàng. |
| sku_orders | number | 1 | Đơn SKU đã thanh toán. |
| main_orders | number | 1 | Đơn (giao dịch) đã thanh toán. |
| traffic | object | Lưu lượng. | |
| viewers | number | 1 | Người xem. |
| views | number | 1 | Lượt vào phòng. |
| impressions | number | 1 | Lượt LIVE hiển thị. |
| enter_room_rate | string | 0.1 | views / impressions. |
| product_impressions | number | 1 | Sản phẩm lượt hiển thị. |
| product_clicks | number | 1 | Sản phẩm lượt nhấp. |
| ctr | string | 0.1 | product_clicks / views (TỈ LỆ, có thể > 1). |
| interactions | object | Interactions. | |
| likes | number | 1 | Likes. |
| comments | number | 1 | Comments. |
| shares | number | 1 | Shares. |
| new_followers | number | 1 | New followers. |
| like_rate | string | 0.1 | trên lượt xem; tương tự comment_rate, share_rate, follow_rate. |
| comment_rate | string | 0.1 | Bình luận tỷ giá. |
| follow_rate | string | 0.1 | Theo dõi tỷ giá. |
| share_rate | string | 0.1 | Chia sẻ tỷ giá. |
| conversion | object | Chuyển đổi. | |
| created_sku_orders | number | 1 | Đơn SKU tạo (kể cả chưa thanh toán). |
| sku_order_rate | string | 0.1 | Sku đơn hàng tỷ giá. |
| avg_price | object | GMV / đơn. | |
| amount | string | 10000 | Số tiền. |
| currency | string | VND | Tiền tệ. |
| click_to_order_rate | object | {sku_order_ctor, main_order_ctor}. | |
| main_order_ctor | string | Minh họa | Main đơn hàng ctor. |
| sku_order_ctor | string | Minh họa | Sku đơn hàng ctor. |
| gpm | object | {watch_gpm, show_gpm} — GMV / 1.000 lượt xem / hiển thị. | |
| show_gpm | string | Minh họa | Show gpm. |
| watch_gpm | string | Minh họa | Xem gpm. |
Response sample
{
"code": 0,
"message": "Success",
"request_id": "DEMO_REQUEST_A_01",
"data": {
"total_count": 1,
"next_page_token": "",
"performance": {
"overall": {
"live_title": "Minh họa",
"start_time": 1793491200,
"end_time": 1793577600,
"duration": 1,
"gmv": {
"amount": "10000",
"currency": "VND"
},
"items_sold": 1,
"unique_viewers": 1,
"impressions": 1
},
"intervals": [
{
"start_time": 1793491200,
"end_time": 1793577600,
"sales": {
"gmv": {
"amount": "10000",
"currency": "VND"
},
"items_sold": 1,
"customers": 1,
"sku_orders": 1,
"main_orders": 1
},
"traffic": {
"viewers": 1,
"views": 1,
"impressions": 1,
"enter_room_rate": "0.1",
"product_impressions": 1,
"product_clicks": 1,
"ctr": "0.1"
},
"interactions": {
"likes": 1,
"comments": 1,
"shares": 1,
"new_followers": 1,
"like_rate": "0.1",
"comment_rate": "0.1",
"follow_rate": "0.1",
"share_rate": "0.1"
},
"conversion": {
"created_sku_orders": 1,
"sku_order_rate": "0.1",
"avg_price": {
"amount": "10000",
"currency": "VND"
},
"click_to_order_rate": {
"main_order_ctor": "Minh họa",
"sku_order_ctor": "Minh họa"
},
"gpm": {
"show_gpm": "Minh họa",
"watch_gpm": "Minh họa"
}
}
}
]
}
}
}
Get started
- Sign up for Partner
- Enable a data type of the Livestream group on the platform page
- Create an API key (tick the TikTok Shop channel)
- Call it as in the examples above