v2.video.get_prodcut_performance_list
GET /api/v2/video/get_prodcut_performance_list
Get specific dữ liệu hiệu suất for products linked with Shopee Video. There is at least a one-day delay.
Đường dẫn Endpoint
URL: https://partner.shopeemobile.com/api/v2/video/get_prodcut_performance_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 item returned by this request. Max is 20. |
| period_type | string | True | Last7d | Period Type. Các giá trị áp dụng: Day Week Month Last7d Last15d Last30d Note: The end date must align with the Period Type. |
| end_date | string | True | 2025-10-30 | The end_date format should be "YYYY-MM-DD". - For Day, Last7d, Last15d, and Last30d, the end_date must before current day. - For Week, the end_date must be Sunday and must be less than or equal to the current week. - For Month, the end_date must be the end of the month and must be less than or equal to the current month. |
| order_by | string | True | PlacedOrders | Use this field to specify which field to use to sort the returned list. Available values: PlacedOrders PlacedSales PlacedUniqueBuyers ConfirmedOrders ConfirmedSales ConfirmedUniqueBuyers |
| sort | string | True | desc | Use this field to specify whether the returned list is sorted in ascending or descending order_by. Available values: asc desc |
| item_id | int64 | False | 1 | Shopee's mã định danh duy nhất for an item. |
| item_name | string | False | test item name | Search by tên sản phẩm. |
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 | int32 | Tổng số product that match the tình trạng. | |
| has_more | boolean | 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 product that match the tình trạng. | |
| shop_id | int64 | 1 | Shopee's mã định danh duy nhất for a shop. |
| item_id | int64 | 1 | Shopee's mã định danh duy nhất for an item. |
| item_name | string | test item name | Name of the item. |
| item_cover_image_url | string | Ảnh bìa url of the item. | |
| item_description | string | desc | Mô tả về the item. |
| placed_orders | int64 | 1 | The number of placed orders for the item. |
| confirmed_orders | int64 | 1 | The number of confirmed orders for the item. |
| placed_sales | float | 1.0 | The placed value of orders for the item. |
| confirmed_sales | float | 1.0 | The confirmed value of orders for the item. |
| placed_unique_buyers | int64 | 1 | Number of unique buyers who placed order for the item. |
| confirmed_unique_buyers | int64 | 1 | Number of unique buyers who confirmed order for the item. |
| fetched_date_range | string | 2025-10-30 | Data Date Range. |
Unirest.setTimeouts(0, 0); HttpResponse<String> response = Unirest.get("https://partner.shopeemobile.com/api/v2/video/get\_prodcut\_performance\_list?access\_token=access\_token&end\_date=2025-10-30&item\_id=1&item\_name=test+item+name&order\_by=PlacedOrders&page\_no=1&page\_size=10&partner\_id=partner\_id&period\_type=Last7d&sign=sign&sort=desc×tamp=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\_prodcut\_performance\_list?access\_token=access\_token&end\_date=2025-10-30&item\_id=1&item\_name=test+item+name&order\_by=PlacedOrders&page\_no=1&page\_size=10&partner\_id=partner\_id&period\_type=Last7d&sign=sign&sort=desc×tamp=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\_prodcut\_performance\_list?access\_token=access\_token&end\_date=2025-10-30&item\_id=1&item\_name=test+item+name&order\_by=PlacedOrders&page\_no=1&page\_size=10&partner\_id=partner\_id&period\_type=Last7d&sign=sign&sort=desc×tamp=timestamp&user\_id=user\_id' import requests url = "https://partner.shopeemobile.com/api/v2/video/get\_prodcut\_performance\_list?access\_token=access\_token&end\_date=2025-10-30&item\_id=1&item\_name=test+item+name&order\_by=PlacedOrders&page\_no=1&page\_size=10&partner\_id=partner\_id&period\_type=Last7d&sign=sign&sort=desc×tamp=timestamp&user\_id=user\_id" payload={} headers = { } response = requests.RPCRequest("GET",url,headers=headers, data=payload, allow_redirects=False) print(response.text)
] } }