Shopee GMV max Ads and FBS Inventory API Now Available

Dear Developers,

The platform has now launched APIs for creating GMV max product ads!

Product Ads(GMV Max Ads) Creation

Before creating manual ads, you can retrieve recommended products, budget, and ROAS value through these APIs:

v2.ads.get_recommended_item_list (recommended product list)

v2.ads.get_product_recommended_roi_target(Get recommended custom ROAS value)

v2.ads.get_create_product_ad_budget_suggestion(budget suggestion based on the ad type and settings.)

You can also create and edit manually selected product ads through the following APIs. You can choose the products to advertise and set bidding mode="auto"for GMV max bidding:

v2.ads.create_manual_product_ads

v2.ads.edit_manual_product_ad_keywords

v2.ads.edit_manual_product_ads

Setting ROAS to 0 enables the platform to automatically apply the optimal ROAS value. You can also set the custom ROAS value.

Other Product Ads Creation

You can create automated product selection ads using the following APIs:

v2.ads.create_auto_product_ads

v2.ads.edit_auto_product_ads

Note: Auto ads features are whitelist-based, consistent with the whitelist in Seller Center.

Related API：

v2.ads.create_manual_product_ads

v2.ads.edit_manual_product_ad_keywords

v2.ads.edit_manual_product_ads

v2.ads.create_auto_product_ads

v2.ads.edit_auto_product_ads

v2.ads.get_create_product_ad_budget_suggestion

Effective Date: Lived

The SBS API module is now live!

For sellers who have joined the Fulfillment by Shopee (FBS) program, the new APIs in this module allow access to inventory-related data from the Inventory module, helping improve warehouse and stock visibility.

Before querying inventory, please first retrieve the warehouse region bound to the shop:

- v2.sbs.get_bound_whs_info: Get bound warehouse by shop ID

Then, use the returned warehouse region to call the following APIs:

- v2.sbs.get_current_inventory: Get current inventory details. Refer to Seller Center "Current Inventory" page

- v2.sbs.get_stock_movement: Query aggregated stock movement data within a specific time range. Matches Seller Center "Stock Movement" page

- v2.sbs.get_stock_aging: Get stock aging information. Refer to Seller Center "Stock Aging" page

- v2.sbs.get_expiry_report: Get inventory expiry report. Refer to "Expiry Report" page data

Note: These APIs are available to sellers who are part of the Fulfillment by Shopee (FBS) program.

Effective Date: Live

尊敬的开发者：

1.平台现已上线 GMV Max 商品广告相关接口！

商品全站推广广告（GMV Max Ads）创建说明

在创建广告前，您可使用以下接口获取系统推荐的商品、ROAS（广告目标回报率）及预算范围：

v2.ads.get_recommended_item_list – 获取推荐商品列表

v2.ads.get_product_recommended_roi_target – 获取推荐的 ROAS（目标回报率）值

v2.ads.get_create_product_ad_budget_suggestion – 获取基于广告设置的系统推荐预算区间

如需创建和管理 GMV Max 广告，可使用以下接口，您可自选推广商品，并设置 bidding_mode="auto" 以启用GMV Max：

v2.ads.create_manual_product_ads

v2.ads.edit_manual_product_ad_keywords

v2.ads.edit_manual_product_ads

设置ROAS=0 平台自动设置最佳的ROAS值，您也可以手动输入ROAS值

📌 其他商品广告类型

您也可以通过以下接口创建系统自动选择商品的广告：

v2.ads.create_auto_product_ads

v2.ads.edit_auto_product_ads

注意：自动广告功能为白名单机制，权限与卖家中心一致。

Shopee GMV max Ads and FBS Inventory API Now Available

资料正文

§1 Shopee GMV max Ads and FBS Inventory API Now Available