v2.ams.get_recommended_affiliate_list

GET /api/v2/ams/get_recommended_affiliate_list

Returns top 200 recommended affiliates that can be added to a campaign

Đường dẫn Endpoint

URL: https://partner.shopeemobile.com/api/v2/ams/get_recommended_affiliate_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ờ.
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_size	int32	True	50	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. Note: The response size will up to 200.

Tham số Response

Tên	Kiểu	Mẫu	Mô tả
error	string	error_auth	Loại lỗi nếu có lỗi xảy ra. Trống nếu không có lỗi.
message	string	Invalid access_token.	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.
total_count	int32	200	Tổng số affiliates that recommended for ID cửa hàng.
affiliate_list	object[]		Recommended Danh sách đơn vị liên kết. Not all return fields will have values.
affiliate_id	int64	12345678	The unique key for the current affiliate.
affiliate_name	string	affiliate a	Tên của the affiliate.
user_name	string	ss	The shopee user name or tên đơn vị liên kết for this affiliate.
portrait_url	string		The portrait url of affiliate.
popular_social_media	object		The popular social media of this affiliate.
platform	string	meta	The platform of this social media account.
follower_count	int64		The follower count of this account.
social_medias	object[]		Social media account danh sách this affiliate.
platform	string	shopee live	The platform of this social media account.
follower_count	int64	1000	The follower count of this account.
social_media_user_name	string	dafffd	Social media name of this account.
total_click	int64	12000	Số lượt nhấp in the last 30 days.
order_range	int64[]	[200,400]	Range number of the orders in the last 30 days.
gmv_range	int64[]	[1000000000000,5000000000000]	Range number of the GMV in the last 30 days.
is_orange_tick_kol	boolean	true	Golden tick means affiliates create high quality contents with good sales conversion in Shopee Live or Shopee Video.
is_good_fulfillment	boolean	true	Good sample fulfillment means that affiliates demonstrate better in free sample fulfillment compared to the majority of affiliates in recent180 days
promote_category_ids	int64[]	[100013,100644,100010]	Three promote ID danh mụcs for this affiliate.
top_popular_contents	object[]		Top popular contents of this affiliate.
platform	string	shopee live	The platform of this affiliate's content. eg. shopee video/shopee live
comment_count	int64	100	The số lượt bình luận of this affiliate's content.
like_count	int64	300	The số lượt thích of this affiliate's content.
view_count	int64	1000	The số lượt xem of this affiliate's content.
cover_url	string	https://123456	The cover link of this affiliate's content.
media_url	string		The media link of this affiliate's content.
top_selling_products	object[]		Top selling items of the affiliate.
item_id	int64	12345678	The ID sản phẩm of this item.

Unirest.setTimeouts(0, 0); HttpResponse<String> response = Unirest.get("https://partner.shopeemobile.com/api/v2/ams/get\_recommended\_affiliate\_list?access\_token=access\_token&page\_size=50&partner\_id=partner\_id&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\_recommended\_affiliate\_list?access\_token=access\_token&page\_size=50&partner\_id=partner\_id&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\_recommended\_affiliate\_list?access\_token=access\_token&page\_size=50&partner\_id=partner\_id&shop\_id=shop\_id&sign=sign&timestamp=timestamp' import requests url = "https://partner.shopeemobile.com/api/v2/ams/get\_recommended\_affiliate\_list?access\_token=access\_token&page\_size=50&partner\_id=partner\_id&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)

, "social_medias": [ { "platform": "shopee live", "follower_count": 1000, "social_media_user_name": "dafffd" } ], "total_click": 12000, "order_range": [ 200, 400 ], "gmv_range": [ 1000000000000, 5000000000000 ], "is_orange_tick_kol": true, "is_good_fulfillment": true, "promote_category_ids": [ 100013, 100644, 100010 ], "top_popular_contents": [ { "platform": "shopee live", "comment_count": 100, "like_count": 300, "view_count": 1000, "cover_url": "https://123456", "media_url": "-" } ], "top_selling_products": [ { "item_id": 12345678 } ] } ] } }