Get Shop Product Performance List — TikTok Shop API

tiktok.analytics.202605.shop_products.performance

GET/analytics/202605/shop_products/performanceVia 360: GET https://partner.quantri360.com/v1/tiktok/analytics/202605/shop_products/performance

Description

Bảng hiệu quả sản phẩm (bản 202605) tách theo NGUỒN BÁN: tổng, LIVE của shop, video của shop, thẻ sản phẩm của shop, affiliate (creator) và tab Cửa hàng — mỗi nguồn có GMV, đơn, khách, hiển thị / nhấp / thêm giỏ và tỉ lệ chuyển đổi; phần tổng có thêm hoàn tiền, phí ship, thuế.

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ố.
Khối nguồn KHÔNG có hoạt động trong kỳ thì vắng hẳn khỏi phản hồi (vd chỉ có affiliate_total_performance mà không có affiliate_live_performance) — kiểm tồn tại trước khi đọc.
Tỉ lệ là chuỗi thập phân 0–1 (có thể > 1, vd click_order_rate "1.3333" khi đơn nhiều hơn lượt nhấp ghi nhận).
Các nguồn KHÔNG cộng lại đúng bằng tổng (cách quy nguồn khác nhau, tab Cửa hàng chồng lên thẻ sản phẩm) — dùng total_performance cho tổng.
Đây là bản mới của GET /analytics/202509/shop_products/performance (bản cũ chỉ có overall_performance).

Request

Endpoint

GET https://partner.quantri360.com/v1/tiktok/analytics/202605/shop_products/performance

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
start_date_ge	query	string	Yes	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	Yes	2026-10-22	Đến TRƯỚC ngày (YYYY-MM-DD, không tính ngày này).
page_size	query	int	No	100	1–100, mặc định 10.
page_token	query	string	No		Trang kế.
sort_field	query	string	No	gmv	`gmv` (mặc định) · `items_sold` · `orders`.
sort_order	query	string	No	DESC	`ASC` · `DESC` (mặc định).
category_filter	query	string	No		Mã ngành hàng CẤP 1, cách dấu phẩy.
product_status_filter	query	string	No	ALL	`LIVE` · `INACTIVE` · `ALL` (mặc định).
currency	query	string	No	LOCAL	`LOCAL` (mặc định) · `USD`.

Pagination

Lặp khi data.next_page_token khác rỗng.

Request examples

curl -s "https://partner.quantri360.com/v1/tiktok/analytics/202605/shop_products/performance?platform_shop_id=7494000000000000000&start_date_ge=2026-10-20&end_date_lt=2026-10-27&page_size=100&sort_field=gmv&sort_order=DESC&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/202605/shop_products/performance",
    params={
        "platform_shop_id": "7494000000000000000",
        "start_date_ge": "2026-10-20",
        "end_date_lt": "2026-10-27",
        "page_size": 100,
        "sort_field": "gmv",
        "sort_order": "DESC",
        "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/202605/shop_products/performance');
for (const [k, v] of Object.entries({"platform_shop_id":"7494000000000000000","start_date_ge":"2026-10-20","end_date_lt":"2026-10-27","page_size":100,"sort_field":"gmv","sort_order":"DESC","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/202605/shop_products/performance' . '?' . http_build_query(['platform_shop_id' => '7494000000000000000', 'start_date_ge' => '2026-10-20', 'end_date_lt' => '2026-10-27', 'page_size' => 100, 'sort_field' => 'gmv', 'sort_order' => 'DESC', '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	YEU_CAU_MINH_HOA	Mã request TikTok.
data	object		Dữ liệu.
latest_available_date	string	2026-11-01	Ngày mới nhất đã có dữ liệu.
total_count	int	1	Tổng số kết quả.
next_page_token	string		Con trỏ trang tiếp theo; rỗng là hết trang.
products	object[]		Danh sách sản phẩm.
id	string	900000000000000001	Mã sản phẩm (chuỗi).
total_performance	object		Tổng mọi nguồn.
gmv	object		GMV.
amount	string	150000	Số tiền.
currency	string	VND	Mã tiền tệ.
gross_merchandise_value	object		Giá trị hàng trước giảm giá.
amount	string	150000	Số tiền.
currency	string	VND	Mã tiền tệ.
gmv_incl_tax	object		GMV gồm thuế.
amount	string	150000	Số tiền.
currency	string	VND	Mã tiền tệ.
tax	object		Thuế.
amount	string	150000	Số tiền.
currency	string	VND	Mã tiền tệ.
orders	int	1	Số đơn hàng.
sku_orders	int	1	Số đơn theo SKU.
items_sold	int	1	Số sản phẩm đã bán.
estimated_customers	int	1	Số khách hàng ước tính.
aov	object		Giá trị đơn trung bình.
amount	string	150000	Số tiền.
currency	string	VND	Mã tiền tệ.
product_impressions	int	1	Số lượt hiển thị sản phẩm.
unique_product_impressions	int	1	Số lượt hiển thị sản phẩm duy nhất.
product_clicks	int	1	Số lượt nhấp sản phẩm.
unique_clicks	int	1	Số lượt nhấp duy nhất.
ctr	string	0.10	Tỷ lệ nhấp.
add_cart_count	int	1	Số lượt thêm vào giỏ.
add_cart_users	int	1	Số người thêm vào giỏ.
add_cart_rate	string	0.10	Tỷ lệ thêm vào giỏ.
click_order_rate	string	0.10	Tỷ lệ nhấp chuyển thành đơn.
refunds	object		Tiền hoàn.
amount	string	150000	Số tiền.
currency	string	VND	Mã tiền tệ.
refunded_items	int	1	Số sản phẩm được hoàn.
refund_customers	int	1	Số khách hàng được hoàn tiền.
shipping_fees	object		Phí ship.
amount	string	150000	Số tiền.
currency	string	VND	Mã tiền tệ.
unique_atc_rate	string	0.10	Tỷ lệ người thêm vào giỏ.
unique_click_order_rate	string	0.10	Tỷ lệ nhấp duy nhất chuyển thành đơn.
unique_ctr	string	0.10	Tỷ lệ nhấp duy nhất.
seller_live_performance	object		LIVE của shop: attributed_gmv, attributed_orders, attributed_sku_orders, attributed_sold_items, estimated_customers, aov, new_live_count, hiển thị / nhấp / thêm giỏ / tỉ lệ.
add_cart_count	number	1	Số lượt thêm vào giỏ.
add_cart_rate	string	0.10	Tỷ lệ thêm vào giỏ.
add_cart_users	number	1	Số người thêm vào giỏ.
aov	object		Giá trị đơn hàng trung bình.
amount	string	150000	Số tiền.
currency	string	VND	Mã tiền tệ.
attributed_gmv	object		GMV được quy gán.
amount	string	150000	Số tiền.
currency	string	VND	Mã tiền tệ.
attributed_orders	number	1	Số đơn được quy gán.
attributed_sku_orders	number	1	Số đơn theo SKU được quy gán.
attributed_sold_items	number	1	Số sản phẩm bán được quy gán.
click_order_rate	string	0.10	Tỷ lệ nhấp chuyển thành đơn.
ctr	string	0.10	Tỷ lệ nhấp.
estimated_customers	number	1	Số khách hàng ước tính.
new_live_count	number	1	Số phiên LIVE mới.
product_clicks	number	1	Số lượt nhấp sản phẩm.
product_impressions	number	1	Số lượt hiển thị sản phẩm.
unique_atc_rate	string	0.10	Tỷ lệ người thêm vào giỏ.
unique_click_order_rate	string	0.10	Tỷ lệ nhấp duy nhất chuyển thành đơn.
unique_clicks	number	1	Số lượt nhấp duy nhất.
unique_ctr	string	0.10	Tỷ lệ nhấp duy nhất.
unique_product_impressions	number	1	Số lượt hiển thị sản phẩm duy nhất.
seller_video_performance	object		Video của shop — như trên, có `new_video_count`.
add_cart_count	number	1	Số lượt thêm vào giỏ.
add_cart_rate	string	0.10	Tỷ lệ thêm vào giỏ.
add_cart_users	number	1	Số người thêm vào giỏ.
aov	object		Giá trị đơn hàng trung bình.
amount	string	150000	Số tiền.
currency	string	VND	Mã tiền tệ.
attributed_gmv	object		GMV được quy gán.
amount	string	150000	Số tiền.
currency	string	VND	Mã tiền tệ.
attributed_orders	number	1	Số đơn được quy gán.
attributed_sku_orders	number	1	Số đơn theo SKU được quy gán.
attributed_sold_items	number	1	Số sản phẩm bán được quy gán.
click_order_rate	string	0.10	Tỷ lệ nhấp chuyển thành đơn.
ctr	string	0.10	Tỷ lệ nhấp.
estimated_customers	number	1	Số khách hàng ước tính.
new_video_count	number	1	Số video mới.
product_clicks	number	1	Số lượt nhấp sản phẩm.
product_impressions	number	1	Số lượt hiển thị sản phẩm.
unique_atc_rate	string	0.10	Tỷ lệ người thêm vào giỏ.
unique_click_order_rate	string	0.10	Tỷ lệ nhấp duy nhất chuyển thành đơn.
unique_clicks	number	1	Số lượt nhấp duy nhất.
unique_ctr	string	0.10	Tỷ lệ nhấp duy nhất.
unique_product_impressions	number	1	Số lượt hiển thị sản phẩm duy nhất.
seller_product_card_performance	object		Thẻ sản phẩm của shop — như trên.
add_cart_count	number	1	Số lượt thêm vào giỏ.
add_cart_rate	string	0.10	Tỷ lệ thêm vào giỏ.
add_cart_users	number	1	Số người thêm vào giỏ.
aov	object		Giá trị đơn hàng trung bình.
amount	string	150000	Số tiền.
currency	string	VND	Mã tiền tệ.
attributed_gmv	object		GMV được quy gán.
amount	string	150000	Số tiền.
currency	string	VND	Mã tiền tệ.
attributed_orders	number	1	Số đơn được quy gán.
attributed_sku_orders	number	1	Số đơn theo SKU được quy gán.
attributed_sold_items	number	1	Số sản phẩm bán được quy gán.
click_order_rate	string	0.10	Tỷ lệ nhấp chuyển thành đơn.
ctr	string	0.10	Tỷ lệ nhấp.
estimated_customers	number	1	Số khách hàng ước tính.
product_clicks	number	1	Số lượt nhấp sản phẩm.
product_impressions	number	1	Số lượt hiển thị sản phẩm.
unique_atc_rate	string	0.10	Tỷ lệ người thêm vào giỏ.
unique_click_order_rate	string	0.10	Tỷ lệ nhấp duy nhất chuyển thành đơn.
unique_clicks	number	1	Số lượt nhấp duy nhất.
unique_ctr	string	0.10	Tỷ lệ nhấp duy nhất.
unique_product_impressions	number	1	Số lượt hiển thị sản phẩm duy nhất.
affiliate_total_performance	object		Creator affiliate (tổng) — như trên, có `avg_daily_creator_posted_content`. Kỳ dài có thêm `affiliate_live_performance` / `affiliate_video_performance`…
add_cart_count	number	1	Số lượt thêm vào giỏ.
add_cart_rate	string	0.10	Tỷ lệ thêm vào giỏ.
add_cart_users	number	1	Số người thêm vào giỏ.
aov	object		Giá trị đơn hàng trung bình.
amount	string	150000	Số tiền.
currency	string	VND	Mã tiền tệ.
attributed_gmv	object		GMV được quy gán.
amount	string	150000	Số tiền.
currency	string	VND	Mã tiền tệ.
attributed_orders	number	1	Số đơn được quy gán.
attributed_sku_orders	number	1	Số đơn theo SKU được quy gán.
attributed_sold_items	number	1	Số sản phẩm bán được quy gán.
avg_daily_creator_posted_content	number	1	Số nội dung creator đăng trung bình mỗi ngày.
click_order_rate	string	0.10	Tỷ lệ nhấp chuyển thành đơn.
ctr	string	0.10	Tỷ lệ nhấp.
estimated_customers	number	1	Số khách hàng ước tính.
product_clicks	number	1	Số lượt nhấp sản phẩm.
product_impressions	number	1	Số lượt hiển thị sản phẩm.
unique_atc_rate	string	0.10	Tỷ lệ người thêm vào giỏ.
unique_click_order_rate	string	0.10	Tỷ lệ nhấp duy nhất chuyển thành đơn.
unique_clicks	number	1	Số lượt nhấp duy nhất.
unique_ctr	string	0.10	Tỷ lệ nhấp duy nhất.
unique_product_impressions	number	1	Số lượt hiển thị sản phẩm duy nhất.
shop_tab_performance	object		Tab Cửa hàng: shop_tab_gmv, shop_tab_sold_items, shop_tab_product_impressions, shop_tab_product_clicks, unique_shop_tab_product_clicks, shop_tab_ctr, shop_tab_ctor_sku, estimated_shop_tab_customers.
estimated_shop_tab_customers	number	1	Số khách hàng ước tính từ thẻ gian hàng.
shop_tab_ctor_sku	string	0.10	Tỷ lệ nhấp chuyển thành đơn theo SKU tại thẻ gian hàng.
shop_tab_ctr	string	0.10	Tỷ lệ nhấp tại thẻ gian hàng.
shop_tab_gmv	object		GMV từ thẻ gian hàng.
amount	string	150000	Số tiền.
currency	string	VND	Mã tiền tệ.
shop_tab_product_clicks	number	1	Số lượt nhấp sản phẩm tại thẻ gian hàng.
shop_tab_product_impressions	number	1	Số lượt hiển thị sản phẩm tại thẻ gian hàng.
shop_tab_sold_items	number	1	Số sản phẩm bán qua thẻ gian hàng.
unique_shop_tab_product_clicks	number	1	Số lượt nhấp duy nhất tại thẻ gian hàng.
affiliate_live_performance	object		Hiệu quả LIVE từ affiliate.
add_cart_count	number	1	Số lượt thêm vào giỏ.
add_cart_rate	string	0.10	Tỷ lệ thêm vào giỏ.
atc_users	number	1	Số người thêm vào giỏ.
click_order_rate	string	0.10	Tỷ lệ nhấp chuyển thành đơn.
ctr	string	0.10	Tỷ lệ nhấp.
live_attributed_gmv	object		GMV được quy gán từ LIVE.
amount	string	150000	Số tiền.
currency	string	VND	Mã tiền tệ.
new_live_count	number	1	Số phiên LIVE mới.
product_clicks	number	1	Số lượt nhấp sản phẩm.
product_impressions	number	1	Số lượt hiển thị sản phẩm.
unique_atc_rate	string	0.10	Tỷ lệ người thêm vào giỏ.
unique_click_order_rate	string	0.10	Tỷ lệ nhấp duy nhất chuyển thành đơn.
unique_clicks	number	1	Số lượt nhấp duy nhất.
unique_ctr	string	0.10	Tỷ lệ nhấp duy nhất.
unique_product_impressions	number	1	Số lượt hiển thị sản phẩm duy nhất.
affiliate_video_performance	object		Hiệu quả video từ affiliate.
add_cart_count	number	1	Số lượt thêm vào giỏ.
add_cart_rate	string	0.10	Tỷ lệ thêm vào giỏ.
atc_users	number	1	Số người thêm vào giỏ.
attributed_video_gmv	object		GMV được quy gán từ video.
amount	string	150000	Số tiền.
currency	string	VND	Mã tiền tệ.
click_order_rate	string	0.10	Tỷ lệ nhấp chuyển thành đơn.
ctr	string	0.10	Tỷ lệ nhấp.
new_video_count	number	1	Số video mới.
product_clicks	number	1	Số lượt nhấp sản phẩm.
product_impressions	number	1	Số lượt hiển thị sản phẩm.
unique_atc_rate	string	0.10	Tỷ lệ người thêm vào giỏ.
unique_click_order_rate	string	0.10	Tỷ lệ nhấp duy nhất chuyển thành đơn.
unique_clicks	number	1	Số lượt nhấp duy nhất.
unique_ctr	string	0.10	Tỷ lệ nhấp duy nhất.
unique_product_impressions	number	1	Số lượt hiển thị sản phẩm duy nhất.

Response sample

{
  "code": 0,
  "message": "Success",
  "request_id": "YEU_CAU_MINH_HOA",
  "data": {
    "latest_available_date": "2026-11-01",
    "total_count": 1,
    "next_page_token": "",
    "products": [
      {
        "id": "900000000000000001",
        "total_performance": {
          "gmv": {
            "amount": "150000",
            "currency": "VND"
          },
          "gross_merchandise_value": {
            "amount": "150000",
            "currency": "VND"
          },
          "gmv_incl_tax": {
            "amount": "150000",
            "currency": "VND"
          },
          "tax": {
            "amount": "150000",
            "currency": "VND"
          },
          "orders": 1,
          "sku_orders": 1,
          "items_sold": 1,
          "estimated_customers": 1,
          "aov": {
            "amount": "150000",
            "currency": "VND"
          },
          "product_impressions": 1,
          "unique_product_impressions": 1,
          "product_clicks": 1,
          "unique_clicks": 1,
          "ctr": "0.10",
          "add_cart_count": 1,
          "add_cart_users": 1,
          "add_cart_rate": "0.10",
          "click_order_rate": "0.10",
          "refunds": {
            "amount": "150000",
            "currency": "VND"
          },
          "refunded_items": 1,
          "refund_customers": 1,
          "shipping_fees": {
            "amount": "150000",
            "currency": "VND"
          },
          "unique_atc_rate": "0.10",
          "unique_click_order_rate": "0.10",
          "unique_ctr": "0.10"
        },
        "seller_live_performance": {
          "add_cart_count": 1,
          "add_cart_rate": "0.10",
          "add_cart_users": 1,
          "aov": {
            "amount": "150000",
            "currency": "VND"
          },
          "attributed_gmv": {
            "amount": "150000",
            "currency": "VND"
          },
          "attributed_orders": 1,
          "attributed_sku_orders": 1,
          "attributed_sold_items": 1,
          "click_order_rate": "0.10",
          "ctr": "0.10",
          "estimated_customers": 1,
          "new_live_count": 1,
          "product_clicks": 1,
          "product_impressions": 1,
          "unique_atc_rate": "0.10",
          "unique_click_order_rate": "0.10",
          "unique_clicks": 1,
          "unique_ctr": "0.10",
          "unique_product_impressions": 1
        },
        "seller_video_performance": {
          "add_cart_count": 1,
          "add_cart_rate": "0.10",
          "add_cart_users": 1,
          "aov": {
            "amount": "150000",
            "currency": "VND"
          },
          "attributed_gmv": {
            "amount": "150000",
            "currency": "VND"
          },
          "attributed_orders": 1,
          "attributed_sku_orders": 1,
          "attributed_sold_items": 1,
          "click_order_rate": "0.10",
          "ctr": "0.10",
          "estimated_customers": 1,
          "new_video_count": 1,
          "product_clicks": 1,
          "product_impressions": 1,
          "unique_atc_rate": "0.10",
          "unique_click_order_rate": "0.10",
          "unique_clicks": 1,
          "unique_ctr": "0.10",
          "unique_product_impressions": 1
        },
        "seller_product_card_performance": {
          "add_cart_count": 1,
          "add_cart_rate": "0.10",
          "add_cart_users": 1,
          "aov": {
            "amount": "150000",
            "currency": "VND"
          },
          "attributed_gmv": {
            "amount": "150000",
            "currency": "VND"
          },
          "attributed_orders": 1,
          "attributed_sku_orders": 1,
          "attributed_sold_items": 1,
          "click_order_rate": "0.10",
          "ctr": "0.10",
          "estimated_customers": 1,
          "product_clicks": 1,
          "product_impressions": 1,
          "unique_atc_rate": "0.10",
          "unique_click_order_rate": "0.10",
          "unique_clicks": 1,
          "unique_ctr": "0.10",
          "unique_product_impressions": 1
        },
        "affiliate_total_performance": {
          "add_cart_count": 1,
          "add_cart_rate": "0.10",
          "add_cart_users": 1,
          "aov": {
            "amount": "150000",
            "currency": "VND"
          },
          "attributed_gmv": {
            "amount": "150000",
            "currency": "VND"
          },
          "attributed_orders": 1,
          "attributed_sku_orders": 1,
          "attributed_sold_items": 1,
          "avg_daily_creator_posted_content": 1,
          "click_order_rate": "0.10",
          "ctr": "0.10",
          "estimated_customers": 1,
          "product_clicks": 1,
          "product_impressions": 1,
          "unique_atc_rate": "0.10",
          "unique_click_order_rate": "0.10",
          "unique_clicks": 1,
          "unique_ctr": "0.10",
          "unique_product_impressions": 1
        },
        "shop_tab_performance": {
          "estimated_shop_tab_customers": 1,
          "shop_tab_ctor_sku": "0.10",
          "shop_tab_ctr": "0.10",
          "shop_tab_gmv": {
            "amount": "150000",
            "currency": "VND"
          },
          "shop_tab_product_clicks": 1,
          "shop_tab_product_impressions": 1,
          "shop_tab_sold_items": 1,
          "unique_shop_tab_product_clicks": 1
        },
        "affiliate_live_performance": {
          "add_cart_count": 1,
          "add_cart_rate": "0.10",
          "atc_users": 1,
          "click_order_rate": "0.10",
          "ctr": "0.10",
          "live_attributed_gmv": {
            "amount": "150000",
            "currency": "VND"
          },
          "new_live_count": 1,
          "product_clicks": 1,
          "product_impressions": 1,
          "unique_atc_rate": "0.10",
          "unique_click_order_rate": "0.10",
          "unique_clicks": 1,
          "unique_ctr": "0.10",
          "unique_product_impressions": 1
        },
        "affiliate_video_performance": {

Get started

Sign up for Partner
Enable a data type of the Sản phẩm group on the platform page
Create an API key (tick the TikTok Shop channel)
Call it as in the examples above