v2.ams.get_content_performance
GET/api/v2/ams/get_content_performanceGọi qua 360: GET https://partner.quantri360.com/v1/shopee_ams/api/v2/ams/get_content_performance
Mô tả API
Hiệu quả TỪNG NỘI DUNG (video Shopee Video / phiên Live) của affiliate có gắn sản phẩm của shop trong kỳ: lượt xem, thích, bình luận, doanh thu, đơn, số bán.
- channel = SocialMedia →
error_param"invalid channel" (API này chỉ có nội dung trên Shopee). AllChannel chạy được = gộp ShopeeVideo + LiveStreaming. - Video đăng từ lâu vẫn xuất hiện nếu có đơn trong kỳ (post_time có thể trước kỳ nhiều tháng).
- Với Live, views / likes là của cả phiên (có thể rất lớn so với số đơn của shop).
Request
Địa chỉ
GET https://partner.quantri360.com/v1/shopee_ams/api/v2/ams/get_content_performance
Xác thực & gian hàng
| Tên | Vị trí | Kiểu | Mẫu | Mô tả |
|---|---|---|---|---|
| Authorization | header | header | Bearer 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_id | query | string | 100001 | Gian 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ên | Vị trí | Kiểu | Bắt buộc | Mẫu | Mô tả |
|---|---|---|---|---|---|
| period_type | query | string | Có | Last30d | Day · Week · Month · Last7d · Last30d — quy tắc ngày như get_shop_performance. |
| start_date | query | string | Có | 20260929 | YYYYMMDD. |
| end_date | query | string | Có | 20261028 | YYYYMMDD. |
| order_type | query | string | Có | ConfirmedOrder | PlacedOrder · ConfirmedOrder. |
| channel | query | string | Có | ShopeeVideo | ShopeeVideo · LiveStreaming · AllChannel (gộp cả hai). SocialMedia bị từ chối. |
| page_no | query | int | Có | 1 | Trang, từ 1. |
| page_size | query | int | Có | 20 | Tối đa 20. |
| affiliate_id | query | int | Không | 10000000007 | Chỉ nội dung của affiliate này. |
| item_id | query | int | Không | 10000000028 | Chỉ nội dung có gắn sản phẩm này. |
Phân trang
Tăng page_no khi response.has_more = true.
Ví dụ request
curl -s "https://partner.quantri360.com/v1/shopee_ams/api/v2/ams/get_content_performance?period_type=Last30d&start_date=20260929&end_date=20261028&order_type=ConfirmedOrder&channel=ShopeeVideo&page_no=1&page_size=20" \ -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_ams/api/v2/ams/get_content_performance",
params={
"period_type": "Last30d",
"start_date": "20260929",
"end_date": "20261028",
"order_type": "ConfirmedOrder",
"channel": "ShopeeVideo",
"page_no": 1,
"page_size": 20
},
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_ams/api/v2/ams/get_content_performance');
for (const [k, v] of Object.entries({"period_type":"Last30d","start_date":"20260929","end_date":"20261028","order_type":"ConfirmedOrder","channel":"ShopeeVideo","page_no":1,"page_size":20})) 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_ams/api/v2/ams/get_content_performance' . '?' . http_build_query(['period_type' => 'Last30d', 'start_date' => '20260929', 'end_date' => '20261028', 'order_type' => 'ConfirmedOrder', 'channel' => 'ShopeeVideo', 'page_no' => 1, 'page_size' => 20]); $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 AMS)
| Tên | Kiểu | Mẫu | Mô tả |
|---|---|---|---|
| request_id | string | d52ca43b277a4f9292fb8be658bfd33d | Mã request của Shopee để tra lỗi. |
| error | string | Mã lỗi Shopee; rỗng = thành công. | |
| message | string | Mô tả lỗi. | |
| response | object | ||
| total_count | int | 28 | Tổng nội dung. |
| has_more | bool | true | |
| list | object[] | Sắp theo doanh thu giảm dần. | |
| content_id | string | 1878819966010391 | Mã video / phiên live (chuỗi). |
| content_title | string | Áo phao siêu nhẹ cho chị em công sở #aophao | Tiêu đề (có thể rỗng). |
| post_time | timestamp | 1731909271 | Video: lúc đăng · Live: lúc bắt đầu. |
| affiliate_name | string | koc_mau | Tên affiliate. |
| affiliate_username | string | koc_mau | Tài khoản Shopee. |
| products | int | 2 | Số sản phẩm gắn trong nội dung. |
| views | int | 26281 | Lượt xem. |
| likes | int | 49 | Lượt thích. |
| comments | int | 5 | Bình luận. |
| sales | string | 2605564 | Doanh thu đơn của shop từ nội dung (VND, chuỗi). |
| orders | int | 3 | Số đơn. |
| items_sold | int | 6 | Số bán. |
| channel | string | ShopeeVideo | `ShopeeVideo` · `LiveStreaming`. |
| fetched_date_range | string | 20260929-20261028 | Khoảng ngày thực tính. |
Mẫu phản hồi
{
"error": "",
"message": "",
"request_id": "e3e3e7f35ef7a6db…",
"response": {
"has_more": true,
"list": [
{
"content_id": "1878819966010391",
"content_title": "Áo phao siêu nhẹ cho chị em công sở #aophao",
"post_time": 1731909271,
"affiliate_name": "koc_mau",
"affiliate_username": "koc_mau",
"products": 2,
"views": 26281,
"likes": 49,
"comments": 5,
"sales": "2605564",
"orders": 3,
"items_sold": 6,
"channel": "ShopeeVideo"
},
{
"content_id": "10000000029",
"content_title": "DEAL CHẤT",
"post_time": 1792946732,
"affiliate_name": "koc_live",
"affiliate_username": "koc_live",
"products": 2,
"views": 790964,
"likes": 1199027,
"comments": 8492,
"sales": "402796",
"orders": 2,
"items_sold": 2,
"channel": "LiveStreaming"
}
],
"total_count": 28,
"fetched_date_range": "20260929-20261028"
}
}
Mã lỗi của Shopee AMS (7)
Bấm để xem
| Mã | Ý nghĩa |
|---|---|
| error_param | Tham số sai / thiếu / sai kiểu — xem `message` để biết tham số nào. |
| error_server | Lỗi hệ thống Shopee — thử lại sau ít phút. |
| 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_limit | Chạ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_limit | Gọ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). |
| shop_banned | Gian hàng đang bị Shopee khóa — mọi API tạm ngưng tới khi gỡ khóa. |
| error_kyc_auth | Gian hàng chưa hoàn tất đăng ký người bán trên Kênh Người Bán. |
Bắt đầu dùng
- Đăng ký tài khoản Partner
- Mở loại dữ liệu thuộc nhóm Affiliate ở trang nền tảng
- Tạo API key (tick kênh Shopee AMS)
- Gọi theo ví dụ ở trên