Update Price

Update the price of multiple SKUs belonging to a product in the ACTIVATE status and not included in any ongoing promotions. Note: The data response field is always empty as there is no additional response data.

---

For common parameters, refer to How to call TikTok Shop APIs - Common Parameters

Note:

• The SKU ID must belong to a product with the ACTIVATE status.
• If you are updating multiple SKUs, all the SKU IDs must belong to the same product. | ^price |object |Y | |SKU pricing information. | ^^amount |string |N |1.32 |Local sellers/Intra-EU sellers The SKU's local display price shown on the product page before any discounts. Refer to Product Pricing for the allowed price ranges in each market.

Global sellers The SKU's local pre-tax price. This excludes any applicable charges such as cross-border shipping costs, taxes, and other fees, and therefore does not appear on the product page. Refer to Product Pricing for the allowed price ranges in each market.

• Note: Not applicable for JP and US shops using China warehouses, please use price.sale_price instead. | ^^currency |string |Y |USD |The currency. Possible values based on the region:
• BRL: Brazil
• CZK: Czech Republic
• EUR: France, Germany, Ireland, Italy, Spain, Netherlands, Belgium, Austria, Greece, Portugal
• GBP: United Kingdom
• HUF: Hungary
• IDR: Indonesia
• JPY: Japan
• MXN: Mexico
• MYR: Malaysia
• PHP: Philippines
• PLN: Poland
• SGD: Singapore
• THB: Thailand
• USD: United States
• VND: Vietnam | ^^sale_price |string |N |1.32 |Global sellers The SKU's local display price shown on the product page before any discounts. Refer to Product Pricing for the allowed price ranges in each market.

Note:

• Applicable only for global sellers.
• Required for the JP and US shops using China warehouses, optional for others.
• This is the definitive final price shown on the product page, all other prices will be ignored. | ^list_price |object |N | |The SKU's list price information. This is equivalent to the manufacturer's suggested retail price (MSRP), or the recommended retail price (RRP). Applicable only for the US market.

Note: This value may appear as the strikethrough price on the product page. However, whether the strikethrough price is shown and the amount shown are subject to the audit team's review and decision based on various pricing information. | ^^amount |string |Y |1 |The price amount. Valid range: [0.01, 7600] Note:

• The value must be equal to or greater than skus.price.amount. Otherwise, it will be discarded.
• If the value is verified to be legitimate by the audit team, it will be stored and returned in the Get Product API. | ^^currency |string |Y |USD |The currency. Possible values: USD | ^external_list_prices |[]object |N | |The SKU list price (e.g. MSRP, RRP) or original price information on external ecommerce platforms. Applicable only for selected sellers in the US market.

Note: This value may appear as the strikethrough price on the product page. However, whether the strikethrough price is shown and the amount shown are subject to the audit team's review and decision based on various pricing information. | ^^source |string |Y |SHOPIFY_COMPARE_AT_PRICE |The external ecommerce platform from which the price is sourced. Possible values:

• SHOPIFY_COMPARE_AT_PRICE: The compare_at_price in Shopify. | ^^amount |string |Y |1 |The price amount. Valid range: [0.01, 7600] | ^^currency |string |Y |USD |The currency. Possible values: USD |

Query

https://open-api.tiktokglobalshop.com/product/202309/products/1729592969712207008/prices/update?app_key=123abc&sign=5361235029d141222525e303d742f9e38aea052d10896d3197ab9d6233730b8c&timestamp=1625484268&shop_cipher=ROW_RHkDDABBAAB8tKAVoAqsMTjsQZFLyNfY

Body

{"skus":[{"id":"1729592969712207013","price":{"amount":"1.32","currency":"USD","sale_price":"1.32"},"list_price":{"amount":"1","currency":"USD"},"external_list_prices":[{"source":"SHOPIFY_COMPARE_AT_PRICE","amount":"1","currency":"USD"}]}]}

{"code":0,"data":{},"message":"Success","request_id":"202203070749000101890810281E8C70B7"}

For common error codes, refer to How to call TikTok Shop APIs - Common Error Code