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

Lấy hiệu quả một video đã đăng — API Shopee Video

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

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

Số liệu LŨY KẾ của một video đã đăng: lượt xem, tương tác, người theo dõi mới, nhấp sản phẩm, đơn, doanh thu, người mua, tỷ lệ chuyển đổi, doanh thu mỗi đơn / mỗi người mua.

  • Số liệu trễ ít nhất 1 ngày.
  • Là lũy kế từ khi đăng (không theo kỳ); theo ngày dùng get_video_detail_metric_trend.

Request

Địa chỉ

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

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ả
post_idquerystringCódemo-post-idMã bài đăng (get_video_list).

Ví dụ request

curl -s "https://partner.quantri360.com/v1/shopee_video/api/v2/video/get_video_detail_performance?post_id=demo-post-id" \
  -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_detail_performance",
    params={
        "post_id": "demo-post-id"
    },
    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_detail_performance');
for (const [k, v] of Object.entries({"post_id":"demo-post-id"})) 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_detail_performance' . '?' . http_build_query(['post_id' => 'demo-post-id']);
$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_infoobject
post_idstring
captionstring
post_timetimestamp1792120504043Mili giây.
durationint40310Mili giây.
cover_image_urlstring
video_urlstring
related_item_countint1Số sản phẩm gắn.
video_performanceobjectVND với trường tiền.
viewsint48
likesint0
commentsint0
sharesint0
followers_growthint0Người theo dõi mới.
product_clicksint9Lượt nhấp sản phẩm.
product_click_ratefloat0.45Tỷ lệ nhấp sản phẩm.
placed_ordersint1Đơn đặt.
placed_salesfloat810760Doanh thu đặt.
sold_itemsint1Sản phẩm bán.
unique_buyersint1
conversion_ratefloat0.009Sản phẩm bán ÷ lượt xem.
sales_per_orderfloat810760
sales_per_buyerfloat810760
placed_discovery_orderint | nullnullChỉ số theo nguồn khám phá / chuyển đổi; có thể null.
placed_discovery_gmvfloat | nullnullChỉ số theo nguồn khám phá / chuyển đổi; có thể null.
confirmed_discovery_orderint | nullnullChỉ số theo nguồn khám phá / chuyển đổi; có thể null.
confirmed_discovery_gmvfloat | nullnullChỉ số theo nguồn khám phá / chuyển đổi; có thể null.
placed_conversion_orderint | nullnullChỉ số theo nguồn khám phá / chuyển đổi; có thể null.
placed_conversion_gmvfloat | nullnullChỉ số theo nguồn khám phá / chuyển đổi; có thể null.
confirmed_conversion_orderint | nullnullChỉ số theo nguồn khám phá / chuyển đổi; có thể null.
confirmed_conversion_gmvfloat | nullnullChỉ số theo nguồn khám phá / chuyển đổi; có thể null.
sales_trendsobject | nullnullXu hướng; có thể null.
order_trendsobject | nullnullXu hướng; có thể null.

Mẫu phản hồi

{
  "error": "",
  "message": "",
  "request_id": "demo-request",
  "response": {
    "video_info": {
      "post_id": "demo-post-id",
      "caption": "Video giới thiệu sản phẩm mẫu",
      "post_time": 1792120504043,
      "duration": 40310,
      "related_item_count": 1,
      "cover_image_url": "https://example.com/demo-image.jpg",
      "video_url": "https://example.com/demo-video.mp4"
    },
    "video_performance": {
      "views": 48,
      "shares": 0,
      "likes": 0,
      "comments": 0,
      "followers_growth": 0,
      "sold_items": 1,
      "placed_orders": 1,
      "placed_sales": 810760,
      "product_clicks": 9,
      "product_click_rate": 0.45,
      "unique_buyers": 1,
      "conversion_rate": 0.009,
      "sales_per_order": 810760,
      "sales_per_buyer": 810760,
      "placed_discovery_order": null,
      "placed_discovery_gmv": null,
      "confirmed_discovery_order": null,
      "confirmed_discovery_gmv": null,
      "placed_conversion_order": null,
      "placed_conversion_gmv": null,
      "confirmed_conversion_order": null,
      "confirmed_conversion_gmv": null,
      "sales_trends": null,
      "order_trends": null
    }
  }
}

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