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

Lấy danh sách video Shopee Video — API Shopee Video

v2.video.get_video_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_list

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

Danh sách video Shopee Video của gian hàng: post_id, video_upload_id, chú thích, ảnh bìa, thời lượng, lượt xem / thích / bình luận và sản phẩm gắn trong giỏ. Là điểm bắt đầu để lấy post_id cho các API hiệu quả từng video.

  • Mọi mốc thời gian của Shopee Video là Unix MILI GIÂY (13 chữ số), khác các module Shopee khác (giây).
  • Chỉ xác định list_type=2 trả video đã đăng; chưa xác định ý nghĩa của giá trị 1.
  • Đồng bộ đầy đủ: lặp page_size 20 tới khi has_more = false; gian hàng nhiều video (vài trăm) cần vài chục lượt gọi.
  • Lỗi invalid_acceess_token (đúng chính tả của Shopee) vẫn còn sau khi 360 đã tự làm mới token → ủy quyền Shopee Video đã mất hiệu lực, cần kết nối lại Shopee Video ở trang Nền tảng.

Request

Địa chỉ

GET https://partner.quantri360.com/v1/shopee_video/api/v2/video/get_video_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.
list_typequeryintCó2Bắt buộc là 1 hoặc 2; 2 trả video đã đăng. Thiếu tham số trả lỗi "list_type must be 1,2".

Phân trang

Tăng page_no (1, 2, 3…) khi response.has_more = true; response.total_count = tổng số video khớp điều kiện.

Ví dụ request

curl -s "https://partner.quantri360.com/v1/shopee_video/api/v2/video/get_video_list?page_no=1&page_size=20&list_type=2" \
  -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_list",
    params={
        "page_no": 1,
        "page_size": 20,
        "list_type": 2
    },
    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_list');
for (const [k, v] of Object.entries({"page_no":1,"page_size":20,"list_type":2})) 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_list' . '?' . http_build_query(['page_no' => 1, 'page_size' => 20, 'list_type' => 2]);
$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_countint743Tổng số video.
has_morebooltrueCòn trang sau.
listobject[]Mỗi phần tử một video.
post_idstringdemo-post-idMã bài đăng — chỉ có khi video đã đăng (status 300). Dùng cho get_video_detail_* .
video_upload_idstringdemo-video-uploadMã tệp video đã tải lên (dùng cho get_cover_list, bản nháp).
statusint300`200` nháp · `300` đã đăng · `400` đã xóa · `500` hẹn giờ đăng · `600` hẹn giờ lỗi.
captionstringSản phẩm mẫuChú thích video (gồm hashtag).
cover_image_urlstringẢnh bìa.
video_urlstringLink phát video (.mp4).
durationint56841Thời lượng, MILI GIÂY.
post_timetimestamp1782286783000Thời điểm đăng — Unix MILI GIÂY.
update_timetimestamp1782286783000Cập nhật lần cuối — mili giây.
viewsint161Lượt xem lũy kế (chỉ video đã đăng).
likesint0Lượt thích.
commentsint0Bình luận.
has_performancebooltrueVideo đã có số liệu hiệu quả hay chưa.
item_listobject[]Sản phẩm gắn trong giỏ của video.
item_idint900002Mã sản phẩm Shopee.
item_namestringSản phẩm mẫuTên sản phẩm.
custom_item_namestringTên hiển thị riêng trong video (nếu đặt).
item_cover_image_urlstringẢnh sản phẩm.
min_pricefloat1072080Giá thấp nhất (VND).
max_pricefloat1072080Giá cao nhất (VND).
stockint140Tồn kho.
shop_idint100001
allow_infoobjectallow_stitch / allow_duet — cho phép ghép / song ca.
allow_stitchbooleanCó cho phép ghép video hay không.
allow_duetbooleanCó cho phép song ca hay không.
scheduled_infoobjectscheduled_post + scheduled_post_time (mili giây) khi hẹn giờ đăng.
scheduled_postbooleanCó hẹn giờ đăng video hay không.
scheduled_post_timetimestampThời điểm hẹn đăng, Unix mili giây; phải có khi scheduled_post=true và để trống khi scheduled_post=false.

Mẫu phản hồi

{
  "error": "",
  "message": "",
  "request_id": "demo-request",
  "response": {
    "total_count": 743,
    "has_more": true,
    "list": [
      {
        "post_id": "demo-post-id",
        "video_upload_id": "demo-video-upload",
        "status": 300,
        "caption": "Video giới thiệu sản phẩm mẫu",
        "cover_image_url": "https://example.com/demo-image.jpg",
        "video_url": "https://example.com/demo-video.mp4",
        "duration": 56841,
        "post_time": 1782286783000,
        "update_time": 1782286783000,
        "views": 161,
        "likes": 0,
        "comments": 0,
        "has_performance": true,
        "item_list": [
          {
            "shop_id": 100001,
            "item_id": 900002,
            "item_name": "Sản phẩm mẫu",
            "custom_item_name": "Sản phẩm mẫu",
            "item_cover_image_url": "https://example.com/demo-image.jpg",
            "min_price": 1072080,
            "max_price": 1072080,
            "stock": 140
          }
        ]
      }
    ]
  }
}

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