v2.ams.get_optimization_suggestion_product

GET /api/v2/ams/get_optimization_suggestion_product

Retrieve products with suggestions to improve performance

Đường dẫn Endpoint

URL: https://partner.shopeemobile.com/api/v2/ams/get_optimization_suggestion_product

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ờ.
shop_id	int	600000	Mã định danh duy nhất của Shopee cho một cửa hàng. Tham số bắt buộc cho hầu hết các API.
sign	string	e318d3e932719916a9f9ebb57e2011961bd47abfa54a36e040d050d8931596e2	Signature generated by partner_id, api path, timestamp, access_token, shop_id and partner_key via HMAC-SHA256 hashing algorithm. More details: https://open.shopee.com/documents?module=87&type=2&id=58&version=2

Tham số Request

Tên	Kiểu	Bắt buộc	Mẫu	Mô tả
page_no	int32	True	1	Chỉ định số trang dữ liệu cần trả về in the current call. Starting from 1. if data is more than one page, the page_no can be some entry to start next call.
page_size	int32	True	20	Each result set is returned as a page of entries. Use the "page_size" filters to control the tối đa number of entries to retrieve per page (i.e., per call). This integer value is used to specify the tối đa number of entries to return in a single "page" of data.The limit of page_size if between 1 and 100.
rcmd_reason_filter	string	True	product_opportunities	Recommended types. Các giá trị áp dụng: product_opportunities optimize_increase_commission_rate optimize_extend_promotion_period

Tham số Response

Tên	Kiểu	Mẫu	Mô tả
error	string	error_business	Loại lỗi nếu có lỗi xảy ra. Trống nếu không có lỗi.
message	string	Please agree to the AMS T&C in Seller Center - Affiliate Marketing Solutions first before using Open API.	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	b937c04e554847789cbf3fe33a0ad5f1	Mã định danh của yêu cầu API dùng để theo dõi lỗi.
response	object		Detail informations you are querying.
item_list	object[]
item_id	int64	123	ID sản phẩm
item_name	string	test	Tên sản phẩm
rcmd_reason	string[]	["severe_shortage","high_popularity"]	Recommend reason. Các giá trị áp dụng: severe_shortage high_popularity optimize_commission_rate extend_time_period
campaign_id	int64	123	ID chiến dịch
commission_rate	float	1.1	Commission Rate, 1.11 means 1.11%, support two decimal places
period_start_time	timestamp	1735660800	Period Start Time
period_end_time	timestamp	1735660800	Period End Time, if get 32503651199 (2999-12-31 23:59:59), it means no limit
affiliate_count	int64	123	Tổng số affiliates who have ever shared the product in the last 90 days
item_sold	int64	123	If the requested rcmd_reason_filter is product_opportunition, it is represented as item sales. Other scenarios are the tổng số item sold for each product of the shop through AMS in the last 90 days
campaign_status	string	Ongoing	Campaign Status: Upcoming Ongoing Terminating
l2_category_order_count	int64	123	Tổng số AMS orders for the product's L2 category in the last 30 days, only available when requested rcmd_reason_filter is product_opportunition
suggest_min_rate	float	1.1	Tối thiểu suggested tỷ lệ hoa hồng, 1.1 means 1.1%, support two decimal places
suggest_max_rate	float	1.2	Tối đa suggested tỷ lệ hoa hồng, 1.2 means 1.2%, support two decimal places
prefill_rate	float	1.1	Prefill rate, 1.1 means 1.1%, support two decimal places
prefill_subsidy_rate	float	1.2	Prefill subsidy rate, platform tỷ lệ hoa hồng calculated based on seller commission, 1.2 means 1.2%, support two decimal places
display_price	string	1.23	Display price
has_subsidy_data	boolean	true	Has subsidy rate
total	int32	1000	Tổng số items that match the tình trạng
has_more	boolean	true	This is to indicate whether the item list is more than one page. If this value is true, you may want to continue to check next page to retrieve orders.

Unirest.setTimeouts(0, 0); HttpResponse<String> response = Unirest.get("https://partner.shopeemobile.com/api/v2/ams/get\_optimization\_suggestion\_product?access\_token=access\_token&page\_no=1&page\_size=20&partner\_id=partner\_id&rcmd\_reason\_filter=product\_opportunities&shop\_id=shop\_id&sign=sign&timestamp=timestamp") .asString();<?php $curl = curl_init(); curl_setopt_array($curl, array( CURLOPT_URL => 'https://partner.shopeemobile.com/api/v2/ams/get\_optimization\_suggestion\_product?access\_token=access\_token&page\_no=1&page\_size=20&partner\_id=partner\_id&rcmd\_reason\_filter=product\_opportunities&shop\_id=shop\_id&sign=sign&timestamp=timestamp', 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/ams/get\_optimization\_suggestion\_product?access\_token=access\_token&page\_no=1&page\_size=20&partner\_id=partner\_id&rcmd\_reason\_filter=product\_opportunities&shop\_id=shop\_id&sign=sign&timestamp=timestamp' import requests url = "https://partner.shopeemobile.com/api/v2/ams/get\_optimization\_suggestion\_product?access\_token=access\_token&page\_no=1&page\_size=20&partner\_id=partner\_id&rcmd\_reason\_filter=product\_opportunities&shop\_id=shop\_id&sign=sign&timestamp=timestamp" payload={} headers = { } response = requests.RPCRequest("GET",url,headers=headers, data=payload, allow_redirects=False) print(response.text)

], "total": 1000, "has_more": true } }