v2.video.get_video_list

GET /api/v2/video/get_video_list

Get the danh sách video in draft status or video already post to Shopee Video.

Đường dẫn Endpoint

URL: https://partner.shopeemobile.com/api/v2/video/get_video_list

Tham số chung

Tên	Kiểu	Mẫu	Mô tả
partner_id	int	1	Partner ID được gán khi đăng ký thành công. Bắt buộc cho tất cả các yêu cầu.
timestamp	timestamp	1610000000	Dùng để chỉ định thời gian của yêu cầu. Bắt buộc cho tất cả các yêu cầu. Hết hạn sau 5 phút.
access_token	string	c09222e3fc40ffb25fc947f738b1abf1	Token truy cập API, dùng để xác định quyền của bạn đối với API. Có thể sử dụng nhiều lần và hết hạn sau 4 giờ.
user_id	int	1	Shopee's mã định danh duy nhất for a user.
sign	string	e318d3e932719916a9f9ebb57e2011961bd47abfa54a36e040d050d8931596e2	Signature generated by(depends on different APIs) partner_id, api path, timestamp, access_token, user_id and partner_key via HMAC-SHA256 hashing algorithm.

Tham số Request

Tên	Kiểu	Bắt buộc	Mẫu	Mô tả
page_no	int32	True	1	The start index of request. Starting from 1.
page_size	int32	True	10	The number of affiliate returned by this request, Max is 20.
list_type	int32	True	1	Search tpye for video in draft status or video already post to Shopee Video. 1: draft 2: post

Tham số Response

Tên	Kiểu	Mẫu	Mô tả
error	string		Loại lỗi nếu có lỗi xảy ra. Trống nếu không có lỗi.
message	string		Chi tiết lỗi nếu có lỗi xảy ra. Trống nếu không có lỗi.
request_id	string	2af852cd-7420-4714-b7cd-33317f6fe548	Mã định danh của yêu cầu API dùng để theo dõi lỗi.
response	object		Detail informations you are querying.
total_count	int64	1	Tổng số video that match the tình trạng.
has_more	boolean	false	This is to indicate whether the danh sách video is more than one page. If this value is true, you may want to continue to check next page to retrieve the rest of data.
list	object		The danh sách video that match the tình trạng.
video_upload_id	string	id-11110201-6ko2m-mczrffx878mba3	ID of uploaded video.
post_id	string	YwOo_gZqCACXbM0UAAAAAA==	The mã định danh duy nhất for post Shopee Video. Only have value when the trạng thái video is 300 (POSTED).
post_time	timestamp	1761188662147	The time when the video post to Shopee Video. Only have value when the trạng thái video is 300 (POSTED).
video_url	string	https://down-bs-id.vod.susercontent.com/c3/50007225/201/A3oxONdWALgpg8thEbEBACc.mp4	Video play url.
status	int32	300	Video current status. Các giá trị áp dụng: 200: DRAFT 300: POSTED 400: DELETED 500: SCHEDULED 600: SCHEDULED_FAILED
cover_image_url	string	https://down-sp-id.vod.susercontent.com/c3/50007225/201/A3oyOUXSAFAbg8thIfYBBgAn.jpg	Ảnh bìa url of the Shopee Video.
caption	string	#tt Tt1	Mô tả về the Shopee Video.
duration	int64	6866	Video thời lượng time in millisecond.
views	int64	1	Số lượt xem of post Shopee Video. Only have value when the trạng thái video is 300 (POSTED).
likes	int64	1	Số lượt thích the post Shopee Video. Only have value when the trạng thái video is 300 (POSTED).
comments	int64	1	Số lượt bình luận the post Shopee Video. Only have value when the trạng thái video is 300 (POSTED).
has_performance	boolean	false	Whether there is video metric data.
item_list	object		Danh sách products linked with the Shopee Video.
shop_id	int64		Shopee's mã định danh duy nhất for a shop of the item.
item_id	int64	34002	Shopee's mã định danh duy nhất for an item.
item_name	string	seller discount	Name of the item.
custom_item_name	string		Name of the item displayed on Shopee Video (max 255 characters).
item_cover_image_url	string		Ảnh bìa url of the item.
min_price	float	100000.0	Min price of the item.
max_price	float	100000.0	Max price of the item.
stock	int64	10	Stock of the item.
allow_info	object		Whether allow stitch and duet.
allow_stitch	boolean	true	Whether allow stitch.
allow_duet	boolean	true	Whether allow duet.
scheduled_info	object		When scheduled_post is true, scheduled_post_time must not empty. When scheduled_post is false, scheduled_post_time must empty.
scheduled_post	boolean	true	Whether post it to Shopee Video at scheduled time.
scheduled_post_time	timestamp	1761734929450	Scheduled thời gian đăng, millisecond timestamp.
update_time	timestamp	1761734929450	The lasted update time the video.

Unirest.setTimeouts(0, 0); HttpResponse<String> response = Unirest.get("https://partner.shopeemobile.com/api/v2/video/get\_video\_list?access\_token=access\_token&list\_type=0&page\_no=0&page\_size=0&partner\_id=partner\_id&sign=sign&timestamp=timestamp&user\_id=user\_id") .asString();<?php $curl = curl_init(); curl_setopt_array($curl, array( CURLOPT_URL => 'https://partner.shopeemobile.com/api/v2/video/get\_video\_list?access\_token=access\_token&list\_type=0&page\_no=0&page\_size=0&partner\_id=partner\_id&sign=sign&timestamp=timestamp&user\_id=user\_id', CURLOPT_RETURNTRANSFER => true, CURLOPT_ENCODING => '', CURLOPT_MAXREDIRS => 10, CURLOPT_TIMEOUT => 0, CURLOPT_FOLLOWLOCATION => true, CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1, CURLOPT_CUSTOMREQUEST => 'GET', CURLOPT_HTTPHEADER => array( 'Content-Type: application/json' ), )); $response = curl_exec($curl); curl_close($curl); echo $response; curl --location --request GET 'https://partner.shopeemobile.com/api/v2/video/get\_video\_list?access\_token=access\_token&list\_type=0&page\_no=0&page\_size=0&partner\_id=partner\_id&sign=sign&timestamp=timestamp&user\_id=user\_id' import requests url = "https://partner.shopeemobile.com/api/v2/video/get\_video\_list?access\_token=access\_token&list\_type=0&page\_no=0&page\_size=0&partner\_id=partner\_id&sign=sign&timestamp=timestamp&user\_id=user\_id" payload={} headers = { } response = requests.RPCRequest("GET",url,headers=headers, data=payload, allow_redirects=False) print(response.text)

, "allow_info": { "allow_stitch": true, "allow_duet": true }, "scheduled_info": { "scheduled_post": true, "scheduled_post_time": 1761734929450 }, "update_time": 1761734929450 } } }