Dành cho developer

Get Shop Performance Per Hour — API TikTok Shop

tiktok.analytics.202510.shop.performance.date.performance_per_hour · 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.

Xem trong mục lục API Trang nền tảng TikTok Shop

tiktok.analytics.202510.shop.performance.date.performance_per_hour

GET/analytics/202510/shop/performance/{date}/performance_per_hourGọi qua 360: GET https://partner.quantri360.com/v1/tiktok/analytics/202510/shop/performance/{date}/performance_per_hour

Mô tả API

Lấy hiệu quả gian hàng theo 24 khung giờ và tổng hợp ngày; ngày dạng YYYY-MM-DD theo múi giờ đăng ký shop.

Gọi qua /v1/tiktok/analytics/202510/shop/performance/{date}/performance_per_hour 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.
intervals gồm 24 khung giờ, index từ 0 đến 23; dữ liệu phản hồi có customers. customers_count có thể vắng trong phản hồi.
Tiền là chuỗi số đi cùng currency. GMV tổng gồm phí vận chuyển, trừ đồng tài trợ của nền tảng và khuyến mại người bán; chưa trừ hủy hoặc hoàn tiền.

Request

Địa chỉ

GET https://partner.quantri360.com/v1/tiktok/analytics/202510/shop/performance/{date}/performance_per_hour

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ả
date	path	string	Có	2026-10-15	Ngày YYYY-MM-DD theo múi giờ đăng ký shop.
currency	query	string	Không	USD	Loại tiền trả về: LOCAL tiền của vùng đăng ký shop; USD đô la Mỹ.

Ví dụ request

curl -s "https://partner.quantri360.com/v1/tiktok/analytics/202510/shop/performance/2026-10-15/performance_per_hour" \
  -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/performance/2026-10-15/performance_per_hour",
    params={},
    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/performance/2026-10-15/performance_per_hour');
for (const [k, v] of Object.entries({})) 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/performance/2026-10-15/performance_per_hour' . '?' . http_build_query([]);
$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	Mã kết quả; 0 là thành công.
message	string	Success	Thông báo kết quả.
request_id	string	DEMO_REQUEST_FBT_01	Mã truy vết yêu cầu.
data	object		Dữ liệu phản hồi.
performance	object		Hiệu quả shop trong ngày, gồm từng giờ, tổng hợp và thời điểm dữ liệu sẵn sàng.
intervals	object[]		Dữ liệu theo 24 khung giờ của ngày.
avg_order_value	object		Giá trị đơn trung bình trong giờ.
amount	string	120.00	Số tiền dạng chuỗi.
currency	string	USD	Mã tiền tệ.
avg_sku_order_value	object		Giá trị đơn SKU trung bình trong giờ.
amount	string	120.00	Số tiền dạng chuỗi.
currency	string	USD	Mã tiền tệ.
customers	int	1	Số khách mua, mỗi người chỉ tính một lần trong giờ.
customers_count	int	1	Số người dùng thanh toán đơn trong giờ; có thể vắng trong phản hồi.
gmv	object		Tổng giá trị hàng hóa.
amount	string	120.00	Số tiền dạng chuỗi.
currency	string	USD	Mã tiền tệ.
index	int	0	Chỉ số giờ 0–23; 0 là 00:00–00:59.
items_sold	int	1	Tổng số đơn vị sản phẩm bán ra trong giờ.
live_attributed_gmv	object		Giá trị hàng hóa quy cho phát trực tiếp trong giờ.
amount	string	120.00	Số tiền dạng chuỗi.
currency	string	USD	Mã tiền tệ.
orders_count	int	1	Số đơn đã thanh toán trong giờ.
product_card_attributed_gmv	object		Giá trị hàng hóa quy cho thẻ sản phẩm trong giờ.
amount	string	120.00	Số tiền dạng chuỗi.
currency	string	USD	Mã tiền tệ.
product_clicks	int	1	Tổng lượt nhấp sản phẩm trong giờ.
product_impressions	int	1	Tổng lượt hiển thị sản phẩm trong giờ.
sku_orders_count	int	1	Số SKU khác nhau đã bán trong giờ.
unique_clicks	int	1	Lượt nhấp sản phẩm duy nhất trong giờ.
unique_product_impressions	int	1	Lượt hiển thị sản phẩm duy nhất trong giờ.
video_attributed_gmv	object		Giá trị hàng hóa quy cho video trong giờ.
amount	string	120.00	Số tiền dạng chuỗi.
currency	string	USD	Mã tiền tệ.
visitors	int	1	Số người dùng duy nhất xem trang chi tiết sản phẩm trước lần cập nhật mới nhất.
latest_available_timestamp	int	1792022400	Thời điểm dữ liệu sẵn sàng mới nhất, Unix giây.
overall	object		Hiệu quả tổng hợp của ngày.
avg_order_value	object		Giá trị đơn trung bình trong ngày.
amount	string	120.00	Số tiền dạng chuỗi.
currency	string	USD	Mã tiền tệ.
avg_sku_order_value	object		Giá trị đơn SKU trung bình trong ngày.
amount	string	120.00	Số tiền dạng chuỗi.
currency	string	USD	Mã tiền tệ.
customers	int	1	Số khách mua, mỗi người chỉ tính một lần trong ngày.
customers_count	int	1	Số người dùng thanh toán đơn trong giờ; có thể vắng trong phản hồi.
gmv	object		Tổng tiền khách trả gồm phí vận chuyển, trừ đồng tài trợ nền tảng và khuyến mại người bán; không trừ hủy hoặc hoàn tiền.
amount	string	120.00	Số tiền dạng chuỗi.
currency	string	USD	Mã tiền tệ.
items_sold	int	1	Tổng số đơn vị sản phẩm bán ra trong ngày.
live_attributed_gmv	object		Giá trị hàng hóa quy cho phát trực tiếp trong ngày.
amount	string	120.00	Số tiền dạng chuỗi.
currency	string	USD	Mã tiền tệ.
orders_count	int	1	Số đơn đã thanh toán trong ngày.
product_card_attributed_gmv	object		Giá trị hàng hóa quy cho thẻ sản phẩm trong ngày.
amount	string	120.00	Số tiền dạng chuỗi.
currency	string	USD	Mã tiền tệ.
product_clicks	int	1	Tổng lượt nhấp sản phẩm trong ngày.
product_impressions	int	1	Tổng lượt hiển thị sản phẩm trong ngày.
sku_orders_count	int	1	Số SKU khác nhau đã bán trong ngày.
unique_clicks	int	1	Lượt nhấp sản phẩm duy nhất trong ngày.
unique_product_impressions	int	1	Lượt hiển thị sản phẩm duy nhất trong ngày.
video_attributed_gmv	object		Giá trị hàng hóa quy cho video trong ngày.
amount	string	120.00	Số tiền dạng chuỗi.
currency	string	USD	Mã tiền tệ.
visitors	int	1	Số người dùng duy nhất xem trang chi tiết sản phẩm trước lần cập nhật mới nhất.

Mẫu phản hồi

{
  "code": 0,
  "message": "Success",
  "request_id": "DEMO_REQUEST_FBT_01",
  "data": {
    "performance": {
      "intervals": [
        {
          "avg_order_value": {
            "amount": "0",
            "currency": "USD"
          },
          "avg_sku_order_value": {
            "amount": "0",
            "currency": "USD"
          },
          "customers": 0,
          "gmv": {
            "amount": "0",
            "currency": "USD"
          },
          "index": 0,
          "items_sold": 0,
          "live_attributed_gmv": {
            "amount": "0",
            "currency": "USD"
          },
          "orders_count": 0,
          "product_card_attributed_gmv": {
            "amount": "0",
            "currency": "USD"
          },
          "product_clicks": 0,
          "product_impressions": 0,
          "sku_orders_count": 0,
          "unique_clicks": 0,
          "unique_product_impressions": 0,
          "video_attributed_gmv": {
            "amount": "0",
            "currency": "USD"
          },
          "visitors": 0
        },
        {
          "avg_order_value": {
            "amount": "0",
            "currency": "USD"
          },
          "avg_sku_order_value": {
            "amount": "0",
            "currency": "USD"
          },
          "customers": 0,
          "gmv": {
            "amount": "0",
            "currency": "USD"
          },
          "index": 1,
          "items_sold": 0,
          "live_attributed_gmv": {
            "amount": "0",
            "currency": "USD"
          },
          "orders_count": 0,
          "product_card_attributed_gmv": {
            "amount": "0",
            "currency": "USD"
          },
          "product_clicks": 0,
          "product_impressions": 0,
          "sku_orders_count": 0,
          "unique_clicks": 0,
          "unique_product_impressions": 0,
          "video_attributed_gmv": {
            "amount": "0",
            "currency": "USD"
          },
          "visitors": 0
        },
        {
          "avg_order_value": {
            "amount": "0",
            "currency": "USD"
          },
          "avg_sku_order_value": {
            "amount": "0",
            "currency": "USD"
          },
          "customers": 0,
          "gmv": {
            "amount": "0",
            "currency": "USD"
          },
          "index": 2,
          "items_sold": 0,
          "live_attributed_gmv": {
            "amount": "0",
            "currency": "USD"
          },
          "orders_count": 0,
          "product_card_attributed_gmv": {
            "amount": "0",
            "currency": "USD"
          },
          "product_clicks": 0,
          "product_impressions": 0,
          "sku_orders_count": 0,
          "unique_clicks": 0,
          "unique_product_impressions": 0,
          "video_attributed_gmv": {
            "amount": "0",
            "currency": "USD"
          },
          "visitors": 0
        },
        {
          "avg_order_value": {
            "amount": "0",
            "currency": "USD"
          },
          "avg_sku_order_value": {
            "amount": "0",
            "currency": "USD"
          },
          "customers": 0,
          "gmv": {
            "amount": "0",
            "currency": "USD"
          },
          "index": 3,
          "items_sold": 0,
          "live_attributed_gmv": {
            "amount": "0",
            "currency": "USD"
          },
          "orders_count": 0,
          "product_card_attributed_gmv": {
            "amount": "0",
            "currency": "USD"
          },
          "product_clicks": 0,
          "product_impressions": 0,
          "sku_orders_count": 0,
          "unique_clicks": 0,
          "unique_product_impressions": 0,
          "video_attributed_gmv": {
            "amount": "0",
            "currency": "USD"
          },
          "visitors": 0
        },
        {
          "avg_order_value": {
            "amount": "0",
            "currency": "USD"
          },
          "avg_sku_order_value": {
            "amount": "0",
            "currency": "USD"
          },
          "customers": 0,
          "gmv": {
            "amount": "0",
            "currency": "USD"
          },
          "index": 4,
          "items_sold": 0,
          "live_attributed_gmv": {
            "amount": "0",
            "currency": "USD"
          },
          "orders_count": 0,
          "product_card_attributed_gmv": {
            "amount": "0",
            "currency": "USD"
          },
          "product_clicks": 0,
          "product_impressions": 0,
          "sku_orders_count": 0,
          "unique_clicks": 0,
          "unique_product_impressions": 0,
          "video_attributed_gmv": {
            "amount": "0",
            "currency": "USD"
          },
          "visitors": 0
        },
        {
          "avg_order_value": {
            "amount": "0",
            "currency": "USD"
          },
          "avg_sku_order_value": {
            "amount": "0",
            "currency": "USD"
          },
          "customers": 0,
          "gmv": {
            "amount": "0",
            "currency": "USD"
          },
          "index": 5,
          "items_sold": 0,
          "live_attributed_gmv": {
            "amount": "0",
            "currency": "USD"
          },
          "orders_count": 0,
          "product_card_attributed_gmv": {
            "amount": "0",
            "currency": "USD"
          },
          "product_clicks": 0,
          "product_impressions": 0,
          "sku_orders_count": 0,
          "unique_clicks": 0,
          "unique_product_impressions": 0,
          "video_attributed_gmv": {
            "amount": "0",
            "currency": "USD"
          },
          "visitors": 0
        },
        {
          "avg_order_value": {
            "amount": "0",
            "currency": "USD"
          },
          "avg_sku_order_value": {
            "amount": "0",
            "currency": "USD"
          },

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