VI | EN
Nhắn Messenger
Dành cho developer

Lấy hiệu quả từng video theo kỳ — API Shopee Video

v2.video.get_video_performance_list · 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.

v2.video.get_video_performance_list

GET/api/v2/video/get_video_performance_listGọi qua 360: GET https://partner.quantri360.com/v1/shopee_video/api/v2/video/get_video_performance_list
Mô tả API

Hiệu quả TỪNG video trong một kỳ (ngày / tuần / tháng / 7–15–30 ngày gần nhất): lượt xem, thích, chia sẻ, tỷ lệ xem hết, thời gian xem trung bình, đơn và doanh thu (đặt / xác nhận). Dùng để xếp hạng video bán tốt, tìm video nhiều xem nhưng không ra đơn.

  • Số liệu trễ ít nhất 1 ngày — end_date hôm nay luôn bị từ chối.
  • period_type viết thường (vd last30d) → error_param "periodType is Illegal".
  • Video không có đơn trong kỳ trả placed_* / confirmed_* = null (không phải 0) — xử lý null khi cộng dồn.
  • Chỉ liệt kê video CÓ số liệu trong kỳ, nên total_count nhỏ hơn tổng số video.

Request

Địa chỉ

GET https://partner.quantri360.com/v1/shopee_video/api/v2/video/get_video_performance_list

Xác thực & gian hàng

TênVị tríKiểuMẫuMô tả
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.

Tham số request

TênVị tríKiểuBắt buộcMẫuMô tả
page_noqueryintCó1Trang, bắt đầu từ 1.
page_sizequeryintCó20Số video mỗi trang, tối đa 20.
period_typequerystringCóLast30dKỳ — PHÂN BIỆT HOA THƯỜNG: Day · Week · Month · Last7d · Last15d · Last30d.
end_datequerystringCó2026-10-28Ngày cuối kỳ YYYY-MM-DD, phải khớp kỳ: Day / Last* là hôm qua trở về trước; Week là một Chủ nhật; Month là ngày cuối tháng (tháng hiện tại trở về trước).
order_byquerystringCóViewsSắp theo: Views · Likes · Comments · AvgViewsDuration.
sortquerystringCódescasc | desc.
captionquerystringKhôngSản phẩm mẫuLọc theo chú thích video.

Phân trang

Tăng page_no khi response.has_more = true (hoặc trang trả đủ page_size).

Ví dụ request

curl -s "https://partner.quantri360.com/v1/shopee_video/api/v2/video/get_video_performance_list?page_no=1&page_size=20&period_type=Last30d&end_date=2026-10-28&order_by=Views&sort=desc" \
  -H "Authorization: Bearer $KEY"
Python
import requests

KEY = "q360_live_..."  # khóa API của brand
r = requests.get(
    "https://partner.quantri360.com/v1/shopee_video/api/v2/video/get_video_performance_list",
    params={
        "page_no": 1,
        "page_size": 20,
        "period_type": "Last30d",
        "end_date": "2026-10-28",
        "order_by": "Views",
        "sort": "desc"
    },
    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/shopee_video/api/v2/video/get_video_performance_list');
for (const [k, v] of Object.entries({"page_no":1,"page_size":20,"period_type":"Last30d","end_date":"2026-10-28","order_by":"Views","sort":"desc"})) 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/shopee_video/api/v2/video/get_video_performance_list' . '?' . http_build_query(['page_no' => 1, 'page_size' => 20, 'period_type' => 'Last30d', 'end_date' => '2026-10-28', 'order_by' => 'Views', 'sort' => 'desc']);
$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 Shopee Video)

TênKiểuMẫuMô tả
request_idstringd52ca43b277a4f9292fb8be658bfd33dMã request của Shopee để tra lỗi.
errorstringMã lỗi Shopee; rỗng = thành công.
messagestringMô tả lỗi.
responseobject
total_countint26Số video có số liệu trong kỳ.
has_morebooltrueCòn trang sau.
listobject[]Mỗi phần tử một video (gồm thông tin video như get_video_list + số liệu kỳ).
post_idstringdemo-post-idMã bài đăng.
captionstring
post_timetimestamp1781335176870Mili giây.
durationstring14233Thời lượng mili giây — kiểu CHUỖI ở API này.
viewsint648Lượt xem trong kỳ.
likesint0
sharesint0
commentsint0
completion_ratefloat0.1574Tỷ lệ xem hết (0–1).
avg_views_durationint6543Thời gian xem trung bình mỗi lượt, mili giây.
placed_ordersint3Đơn ĐẶT từ video (gồm đơn sau đó hủy) — `null` khi không có đơn.
placed_salesfloat3222453Doanh thu đặt (VND).
placed_item_soldint5Số sản phẩm đặt.
confirmed_ordersint1Đơn XÁC NHẬN (đã thanh toán / không hủy).
confirmed_salesfloat279173Doanh thu xác nhận (VND).
confirmed_item_soldint1
fetched_date_rangestring2026-07-08Ngày số liệu được tính.
statusint300
post_typeint0Loại bài đăng.
video_upload_idstring
cover_image_urlstring
video_urlstring

Mẫu phản hồi

{
  "error": "",
  "message": "",
  "request_id": "demo-request",
  "response": {
    "total_count": 26,
    "has_more": true,
    "list": [
      {
        "post_id": "demo-post-id",
        "video_upload_id": "demo-video-upload",
        "status": 300,
        "post_type": 0,
        "caption": "Video giới thiệu sản phẩm mẫu",
        "post_time": 1781335176870,
        "duration": "14233",
        "cover_image_url": "https://example.com/demo-image.jpg",
        "video_url": "https://example.com/demo-video.mp4",
        "views": 648,
        "likes": 0,
        "shares": 0,
        "comments": 0,
        "completion_rate": 0.1574,
        "avg_views_duration": 6543,
        "placed_orders": null,
        "placed_sales": null,
        "placed_item_sold": null,
        "confirmed_orders": null,
        "confirmed_sales": null,
        "confirmed_item_sold": null,
        "fetched_date_range": "2026-07-08"
      }
    ]
  }
}

Mã lỗi của Shopee Video (6)

Bấm để xem
MãÝ nghĩa
error_paramTham số sai / thiếu / sai kiểu — xem `message` để biết tham số nào.
error_authỦy quyền gian hàng cho 360 đã hết hạn hoặc bị thu hồi (360 đã tự làm mới token một lần) — chủ gian hàng kết nối lại Shopee trong Partner.
error_limitChạm hạn mức gọi Shopee trong ngày của kết nối — 360 trả kèm thời điểm thử lại; giảm tần suất gọi.
error_rate_limitGọi quá nhanh — chờ vài giây rồi gọi lại (360 cũng giới hạn theo key: 429 + Retry-After).
user_no_linkedTài khoản chưa liên kết với 360 — kết nối lại trong Partner.
user_bannedTài khoản đang bị Shopee khóa, mọi API tạm ngưng tới khi gỡ khóa.

Bắt đầu dùng

  1. Đăng ký tài khoản Partner
  2. Mở loại dữ liệu thuộc nhóm Video ở trang nền tảng
  3. Tạo API key (tick kênh Shopee Video)
  4. Gọi theo ví dụ ở trên