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

Lấy xu hướng chỉ số Shopee Video theo thời gian — API Shopee Video

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

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

Xu hướng chỉ số Shopee Video của cả gian hàng THEO TỪNG NGÀY trong kỳ: doanh thu, đơn, người mua, lượt xem, thêm giỏ, CTR, GPM, tương tác. Dùng vẽ biểu đồ ngày.

  • Số liệu trễ ít nhất 1 ngày; ghi đè theo data_period khi đồng bộ lại.
  • Cùng bộ chỉ số với get_overview_performance nhưng tách theo ngày.

Request

Địa chỉ

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

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ả
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, khớp kỳ như get_overview_performance.

Ví dụ request

curl -s "https://partner.quantri360.com/v1/shopee_video/api/v2/video/get_metric_trend?period_type=Last30d&end_date=2026-10-28" \
  -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_metric_trend",
    params={
        "period_type": "Last30d",
        "end_date": "2026-10-28"
    },
    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_metric_trend');
for (const [k, v] of Object.entries({"period_type":"Last30d","end_date":"2026-10-28"})) 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_metric_trend' . '?' . http_build_query(['period_type' => 'Last30d', 'end_date' => '2026-10-28']);
$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
video_total_metric_listobject[]Mỗi phần tử một ngày.
data_periodstring2026-07-08Ngày (YYYY-MM-DD).
placed_salesfloat3222453Doanh thu đặt (VND).
placed_ordersint3
placed_item_soldint5
confirmed_salesfloat279173Doanh thu xác nhận (VND).
confirmed_ordersint1
confirmed_item_soldint1
total_viewsint742Lượt xem.
effective_viewsint337Lượt xem > 3 giây.
total_viewersint406Người xem.
avg_view_durationint7299Mili giây.
total_atcint17Thêm giỏ.
ctrfloat0.1867Nhấp sản phẩm ÷ lượt xem.
placed_co_ratefloat0.0323
confirmed_co_ratefloat0.0108
placed_absfloat1074151Giá trị trung bình đơn đặt.
confirmed_absfloat279173
placed_gpmfloat4342928.5714Doanh thu đặt / 1.000 lượt xem.
confirmed_gpmfloat376243.9353
placed_buyersint3
confirmed_buyersint1
total_likesint0
total_sharesint0
total_commentsint0
video_new_followersint14
video_with_productsint2
placed_revenue_generating_videosint3
confirmed_revenue_generating_videosint1

Mẫu phản hồi

{
  "error": "",
  "message": "",
  "request_id": "demo-request",
  "response": {
    "video_total_metric_list": [
      {
        "data_period": "2026-07-08",
        "placed_sales": 3222453,
        "placed_orders": 3,
        "placed_item_sold": 5,
        "confirmed_sales": 279173,
        "confirmed_orders": 1,
        "confirmed_item_sold": 1,
        "total_views": 742,
        "effective_views": 337,
        "total_viewers": 406,
        "avg_view_duration": 7299,
        "total_atc": 17,
        "ctr": 0.1867,
        "placed_co_rate": 0.0323,
        "confirmed_co_rate": 0.0108,
        "placed_abs": 1074151,
        "confirmed_abs": 279173,
        "placed_gpm": 4342928.5714,
        "confirmed_gpm": 376243.9353,
        "placed_buyers": 3,
        "confirmed_buyers": 1,
        "total_likes": 0,
        "total_shares": 0,
        "total_comments": 0,
        "video_new_followers": 14,
        "video_with_products": 2,
        "placed_revenue_generating_videos": 3,
        "confirmed_revenue_generating_videos": 1
      }
    ]
  }
}

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