POST Publish Global Product
Publish Global Product Seller Required scope: seller.global_product.write Publish and convert a global product to local products in one or multiple shops in supported markets. After publishing, the product is sent for review by TikTok Shop in the respective markets. For sellers in the EU market, the provided information will also be automatically translated into all EU languages supported by TikTok Shop. Note:
- You can only publish in each market once. To change product information, edit the global product by using the Edit Global Product API
. The changes will be automatically synchronized to all markets where the product is published
- Use the Get Product API
to obtain the converted local product information in the target market's language.
- Use the Edit Product API
or Partial Edit Product API
to edit the local product information, if necessary. Version 202309
POST/product/202309/global_products/{global_product_id}/publish
Request
Path
| Properties | Type | Description |
|---|---|---|
| global_product_id Required | string | The global product id. |
Header
| Properties | Type | Description |
|---|---|---|
| content-type Required | string | Allowed type: application/json |
| x-tts-access-token Required | string | The seller access_token value from Get Access Token, when user_type = 0. Follow this guide to get seller access_token. |
Query
| Properties | Type | Description |
|---|---|---|
| app_key Required | string | Every single app will have a unique key. Please use the specific key assigned to your app. |
| sign Required | string | Signature generated by gen algorithm. When you send API requests to TTS, you must sign them so that TTS can identify the senders. |
| timestamp Required | int | Unix timestamp GMT (UTC+00:00). This timestamp is used across all API requests. Developers can use this convert to local time. |
Body
| Properties | Type | Description |
|---|---|---|
| publish_target Required | []object | Target markets for publishing global products. |
Example
CurlGoNode.jsJavaEnable word wrap
Response Parameters
| Properties | Type | Description |
|---|---|---|
| code | int | The success or failure status code returned in API response. |
| message | string | The success or failure messages returned in API response. Reasons of failure will be described in the message. |
| request_id | string | Request log |
| data | object | Specific return information |
Example
JSONEnable word wrap
Error Code
View common error codes
| Code | Message | | --- | --- | | 12019004 | Seller is inactive | | 12019010 | product price is invalid | | 12019016 | Unable to publish or sync products to target markets due to missing or invalid warehouse details. | | 12019028 | Multiple warehouses detected. Include all warehouse IDs and the corresponding details and try again. | | 12019113 | product status is invalid | | 12019121 | calculate price error | | 12019150 | The product ID does not exist. | | 12019212 | region already published | | 12052055 | The SKU inventory quantity for the warehouse must be within allowed limits. | | 12052084 | The provided currency is not available for this shop/region. | | 12052117 | seller publish global product over limit and save draft | | 12052145 | activity warehouse not allowed to be deleted | | 12052146 | The specified inventory quantity is too low. It must be greater than the locked quantity (e.g. for committed orders, campaigns, creators) to ensure a non-negative available stock. | | 12052260 | The product ID does not exist | | 12052379 | the cover region of share warehouse can not cover the the product region | | 12052424 | Missing 'sale price' value | | 12052531 | The warehouse is disabled. | | 12052556 | The SKU id not exist. | | 12052700 | The seller is inactive. | | 12052701 | do not support cross-boarder seller create local product directly | | 36009003 | Internal error. Please try again. If the issue persists after multiple attempts, please contact platform support. | | 12052901 | The product in its current status is not available for this operation. Change the product status and try again. | | 12052903 | The publish region is inactive. | | 12052910 | Invalid input parameters. Refer to the API documentation for details. |
Is this content helpful?Helpful
Not Helpful
PreviousNext