v2.video.get_video_detail_performance
GET /api/v2/video/get_video_detail_performance
Get detailed dữ liệu hiệu suất for individual post Shopee Video. There is at least a one-day delay.
Đường dẫn Endpoint
URL: https://partner.shopeemobile.com/api/v2/video/get_video_detail_performance
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ả |
|---|---|---|---|---|
| post_id | string | True | YwOo_gZqCACXbM0UAAAAAA== | A mã định danh duy nhất for Shopee videos. |
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. | |
| video_info | object | Video post detail informations you are querying. | |
| post_id | string | YwOo_gZqCACXbM0UAAAAAA== | A mã định danh duy nhất for Shopee videos. |
| post_time | timestamp | 1761188662147 | The time when the video post to Shopee Video. |
| video_url | string | https://down-bs-id.vod.susercontent.com/c3/50007225/201/A3oxONdWALgpg8thEbEBACc.mp4 | Video play url. |
| 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. |
| related_item_count | int64 | 1 | Number of products linked with the Shopee Video. |
| video_performance | object | Overall dữ liệu hiệu suất of the video you are querying. | |
| views | int64 | 1 | Amount of views from the video. |
| likes | int64 | 1 | Total likes from the video. |
| comments | int64 | 1 | Total comments from the video. |
| shares | int64 | 1 | Total shares from the video. |
| followers_growth | int64 | 1 | Amount of new followers from the Video. |
| placed_orders | int64 | 1 | Amount of product orders from the video. |
| placed_sales | float | 1.0 | Amount of product sales from the video. |
| unique_buyers | int64 | 1 | Buyers of the products in the video. |
| conversion_rate | float | 1.0 | Amount of products sold from the video/amount of views from the video. |
| sold_items | int64 | 1 | Amount of products sold from the video. |
| product_clicks | int64 | 1 | The product click value of orders for item. |
| product_click_rate | float | 2.0 | The product click rate value of orders for item. |
| sales_per_order | float | 1.0 | Amount of product sales from the video/amount of product orders from the video. |
| sales_per_buyer | float | 1.0 | Amount of product sales from the video/amount of buyers from the video. |
Unirest.setTimeouts(0, 0); HttpResponse<String> response = Unirest.get("https://partner.shopeemobile.com/api/v2/video/get\_video\_detail\_performance?access\_token=access\_token&partner\_id=partner\_id&post\_id=YwOo\_gZqCACXbM0UAAAAAA%3D%3D&sign=sign×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\_video\_detail\_performance?access\_token=access\_token&partner\_id=partner\_id&post\_id=YwOo\_gZqCACXbM0UAAAAAA%3D%3D&sign=sign×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\_video\_detail\_performance?access\_token=access\_token&partner\_id=partner\_id&post\_id=YwOo\_gZqCACXbM0UAAAAAA%3D%3D&sign=sign×tamp=timestamp&user\_id=user\_id' import requests url = "https://partner.shopeemobile.com/api/v2/video/get\_video\_detail\_performance?access\_token=access\_token&partner\_id=partner\_id&post\_id=YwOo\_gZqCACXbM0UAAAAAA%3D%3D&sign=sign×tamp=timestamp&user\_id=user\_id" payload={} headers = { } response = requests.RPCRequest("GET",url,headers=headers, data=payload, allow_redirects=False) print(response.text)
, "video_performance": { "views": 1, "likes": 1, "comments": 1, "shares": 1, "followers_growth": 1, "placed_orders": 1, "placed_sales": 1, "unique_buyers": 1, "conversion_rate": 1, "sold_items": 1, "product_clicks": 1, "product_click_rate": 2, "sales_per_order": 1, "sales_per_buyer": 1 } } }