Skip to main content

POST Replicate Product

Replicate Product Shop Required scope: seller.product.write Description of [POST]/product/:version/Replicate_Product Version 202507

POST/product/202507/products/{product_id}/global_replicate

Request

Path

PropertiesTypeDescription
product_id RequiredstringThe product ID in TikTok Shop.

Header

PropertiesTypeDescription
content-type RequiredstringAllowed type: application/json
x-tts-access-token RequiredstringThe seller access_token value from Get Access Token, when user_type = 0. Follow this guide to get seller access_token.

Query

PropertiesTypeDescription
app_key RequiredstringEvery single app will have a unique key. Please use the specific key assigned to your app.
sign RequiredstringSignature generated by gen algorithm. When you send API requests to TTS, you must sign them so that TTS can identify the senders.
timestamp RequiredintUnix timestamp GMT (UTC+00:00). This timestamp is used across all API requests. Developers can use this convert to local time.
shop_cipher RequiredstringUse this property to pass shop information in requesting the API. Failure in passing the correct value when requesting the API for cross-border shops will return incorrect response. Get by API Get Authorization Shop

Body

PropertiesTypeDescription
replicate_target[]objectTarget markets for replicating the local product.
inventory_modestringDefines the inventory mode for the duplicated source product. This parameter supports two modes: SHARED and EXCLUSIVE. - SHARED: In this mode, the inventory of all interconnected (shared) products must be strictly consistent; otherwise, an error will be returned.- EXCLUSIVE: In this mode, the inventory for each product can be set independently without affecting others. Applicability:This feature is applicable ONLY for the EU market. Default Value:If left empty, the system defaults to the EXCLUSIVE mode.

Example

CurlGoNode.jsJavaEnable word wrap

Response Parameters

PropertiesTypeDescription
codeintThe success or failure status code returned in API response.
messagestringThe success or failure messages returned in API response. Reasons of failure will be described in the message.
request_idstringRequest log
dataobjectSpecific return information

Example

JSONEnable word wrap

Error Code

View common error codes

| Code | Message | | --- | --- | | 12052500 | A replica already exists for this product in the stated region. Only one replica is allowed per region. | | 12052501 | This operation is only available for shops using the LOCAL_REPLICATION listing method. Your shop is currently using the GLOBAL_PUBLISHING method. | | 12052503 | If the inventory allocation mode is SHARED, the inventory quantity must be the same across all SKUs. | | 12052518 | The number of SKUs provided do not match that of the source product. Please ensure that you provide complete SKU data. |

Is this content helpful?Helpful

Not Helpful

PreviousNext