Update Price

POST

/product/202309/products/{product_id}/prices/update

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.

Authorizations

• accessToken

Parameters

Path Parameters

product_id

required

string

The product ID generated by TikTok Shop.

Query Parameters

shop_cipher

required

string

Identifies the shop. Obtain it from the Get Authorized Shops API.

Request Body^required

Media typeapplication/json

object

skus

required

A list of Stock Keeping Units (SKUs) used to identify distinct variants of the product.

Array<object>

object

id

required

The SKU ID generated by TikTok Shop. One product can contain multiple SKU IDs.

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.

string

price

required

SKU pricing information.

object

amount

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.

string

currency

required

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

string

Allowed values: BRL CZK EUR GBP HUF IDR JPY MXN MYR PHP PLN SGD THB USD VND

sale_price

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 for all global sellers.
• Required for 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.

string

list_price

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.

object

amount

required

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.

string

currency

required

The currency. Possible values: USD

string

Allowed values: USD

external_list_prices

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.

Array<object>

object

source

required

The external ecommerce platform from which the price is sourced. Possible values:

• SHOPIFY_COMPARE_AT_PRICE: The compare_at_price in Shopify.

string

Allowed values: SHOPIFY_COMPARE_AT_PRICE

amount

required

The price amount. Valid range: [0.01, 7600]

string

currency

required

The currency. Possible values: USD

string

Allowed values: USD

Example

{
  "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"
        }
      ]
    }
  ]
}

Responses

200

Success

Media typeapplication/json

object

code

Status code; 0 means success.

integer format: int64

message

Success or failure message.

string

request_id

Request log ID.

string

data

object

Example

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