VI | EN
Message us on Messenger
Developer resources

Get Shop LIVE Minute Performance — TikTok Shop API

tiktok.analytics.202510.shop_lives.live_id.performance_per_minutes · 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.

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. ctr tính trên lượt xem nên có thể > 1.
  • Đã gặp thật: overall.gmv trả "80.31" kèm currency "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ộng intervals[].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

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

Request parameters

NameInTypeRequiredSampleDescription
live_idpathstringYes7693774836657277717Mã phiên LIVE — id của GET /analytics/202509/shop_lives/performance (live_stream_sessions[].id).
currencyquerystringNoLOCALLOCAL (tiền gian hàng, mặc định) · USD.
page_tokenquerystringNonext_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&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/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)

NameTypeSampleDescription
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_idstringDEMO_REQUEST_A_01Mã request TikTok.
dataobjectDữ liệu.
total_countnumber1Tổng số phút.
next_page_tokenstringTiếp theo trang con trỏ.
performanceobjectHiệu quả.
overallobjectTổng phiên (lặp lại ở mọi trang).
live_titlestringMinh họaLive tiêu đề.
start_timenumber1793491200Unix giây.
end_timenumber1793577600Kết thúc thời điểm.
durationnumber1Giây.
gmvobject{amount, currency} — xem lưu ý.
amountstring10000Số tiền.
currencystringVNDTiền tệ.
items_soldnumber1Items sold.
unique_viewersnumber1Người xem duy nhất.
impressionsnumber1Lượt LIVE được hiển thị.
intervalsobject[]Mỗi phút một phần tử.
start_timenumber1793491200Unix giây.
end_timenumber1793577600Kết thúc thời điểm.
salesobjectDoanh số.
gmvobject{amount, currency}.
amountstring10000Số tiền.
currencystringVNDTiền tệ.
items_soldnumber1Items sold.
customersnumber1Khách hàng.
sku_ordersnumber1Đơn SKU đã thanh toán.
main_ordersnumber1Đơn (giao dịch) đã thanh toán.
trafficobjectLưu lượng.
viewersnumber1Người xem.
viewsnumber1Lượt vào phòng.
impressionsnumber1Lượt LIVE hiển thị.
enter_room_ratestring0.1views / impressions.
product_impressionsnumber1Sản phẩm lượt hiển thị.
product_clicksnumber1Sản phẩm lượt nhấp.
ctrstring0.1product_clicks / views (TỈ LỆ, có thể > 1).
interactionsobjectInteractions.
likesnumber1Likes.
commentsnumber1Comments.
sharesnumber1Shares.
new_followersnumber1New followers.
like_ratestring0.1trên lượt xem; tương tự comment_rate, share_rate, follow_rate.
comment_ratestring0.1Bình luận tỷ giá.
follow_ratestring0.1Theo dõi tỷ giá.
share_ratestring0.1Chia sẻ tỷ giá.
conversionobjectChuyển đổi.
created_sku_ordersnumber1Đơn SKU tạo (kể cả chưa thanh toán).
sku_order_ratestring0.1Sku đơn hàng tỷ giá.
avg_priceobjectGMV / đơn.
amountstring10000Số tiền.
currencystringVNDTiền tệ.
click_to_order_rateobject{sku_order_ctor, main_order_ctor}.
main_order_ctorstringMinh họaMain đơn hàng ctor.
sku_order_ctorstringMinh họaSku đơn hàng ctor.
gpmobject{watch_gpm, show_gpm} — GMV / 1.000 lượt xem / hiển thị.
show_gpmstringMinh họaShow gpm.
watch_gpmstringMinh họaXem 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

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