Chuyển tới nội dung chính

v2.ads.get_recommended_item_list

GET /api/v2/ads/get_recommended_item_list

Use this API to get the list of recommended SKU (Shop level) with the corresponding tag, i.e top search/best selling/best ROI tag.

Đường dẫn Endpoint

URL: https://partner.shopeemobile.com/api/v2/ads/get_recommended_item_list

Tham số chung

TênKiểuMẫuMô tả
partner_idint1Partner ID được cấp khi đăng ký thành công. Bắt buộc cho mọi yêu cầu.
timestamptimestamp1610000000Dùng để xác định thời điểm của yêu cầu. Bắt buộc cho mọi yêu cầu. Hết hạn sau 5 phút.
access_tokenstringc09222e3fc40ffb25fc947f738b1abf1Token truy cập API, dùng để xác định quyền của bạn. Có thể dùng nhiều lần và hết hạn sau 4 giờ.
shop_idint600000Mã định danh duy nhất của Shopee cho cửa hàng. Tham số bắt buộc cho hầu hết các API.
signstringe318d3e932719916a9f9ebb57e2011961bd47abfa54a36e040d050d8931596e2Signature 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

Không có tham số yêu cầu.

Tham số Response

TênKiểuMẫuMô tả
errorstringMã lỗi, để trống khi không có lỗi
messagestringMô tả lỗi
warningstringNếu một số dữ liệu không thể phản hồi bình thường, đặt cảnh báo
request_idstring6f235f4a343e4feb8a9ed74c439f6663request id là duy nhất cho mỗi yêu cầu
responseobject[]Nội dung phản hồi
item_idint321234Recommended SKU's item id
item_status_liststring[]["blocked"]This is param to indicate the status of items, so sellers can know whether an item is eligible for ads or not.
sku_tag_liststring[]["best selling"]The corresponding tag (or tags) that belong to item_id, sequences follow as best selling>best ROI>top search
ongoing_ad_type_liststring[]["search ads", "discovery ads"]Current status of the ad on this item. For example- no ongoing promotion, search ads, discovery ads, boost ads