POST Create Global Product
Create Global Product Seller Required scope: seller.global_product.write Create global products to be sold in one or multiple shops outside of the seller's base country. You can only create global products in AVAILABLE product categories. For other categories, contact your account manager for assistance. After product creation, use the Publish Global Product API
to publish and translate the product in the desired markets. Key concept: Global products are products created by cross-border sellers to be sold in shops outside of their base country. With global products, cross-border sellers operating across multiple markets can avoid creating the same product for each shop individually. Instead, they just need to create a single global product, which can be published and synced to all their shops, simplifying product management across markets. Note:
- This API is applicable only for intra-EU sellers and global sellers. To create and list local products intended for sale exclusively in local shops, use the Create Product API
instead.
- There may be a limit to the number of products you can list per day. We recommend prioritizing the creation of key products first to ensure they get published. You can find your listing limit on the Seller Center homepage.
- The language used in the product content must align with the target market's language (e.g. don't use Chinese), otherwise the listing will fail or be rejected. Version 202309
POST/product/202309/global_products
Request
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 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| title Required | string | The product title. Title length:- DE, ES, FR, IE, IT, JP, UK, US: [1, 255] - MX:[1,300] - Other regions: [25, 255] | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| description Required | string | The product description in HTML format.Note:- The content must conform to the HTML syntax. All HTML tags are accepted but to optimize display on the TikTok Shop product detail page, the system will automatically convert certain tags into alternative formats, such as rendering tags as images.- Max length: 10,000 characters.- Image guidelines: You must use TikTok Shop image URLs. Max 30
Example CurlGoNode.jsJavaEnable word wrap Response Parameters
Example JSONEnable word wrap Error Code View common error codes | Code | Message | | --- | --- | | 36009003 | Internal error. Please try again. If the issue persists after multiple attempts, please contact platform support. | | 12019006 | product description is invalid | | 12019011 | product package weight is invalid | | 12019013 | brand id is invalid | | 12019030 | property is invalid | | 12019064 | No matching categories. Provide the full name of your product, edit its product properties, and try again. | | 12019117 | Missing variations (sales attributes). When there are multiple SKUs in a product, each SKU must include variation (sales attribute) details that explain how it is different from other SKUs in the product. | | 12052012 | Incorrect price format | | 12052013 | The product description cannot exceed maximum characters | | 12052015 | The product description is required | | 12052016 | The parcel weight is required | | 12052023 | Category does not exist | | 12052024 | Category is not final category | | 12052026 | Brand does not exist | | 12052028 | Main product image is required | | 12052048 | You cannot edit the specified product(s) as it isn't listed in your account or shop. | | 12052050 | A single product cannot have more than 100 different SKUs | | 12052051 | The product name exceed max limit characters | | 12052054 | The seller SKU text length cannot exceed max limit characters | | 12052055 | The SKU inventory quantity for the warehouse must be within allowed limits. | | 12052056 | The num of image in description cannot exceed max limit | | 12052073 | The product price is invalid | | 12052084 | The provided currency is not available for this shop/region. | | 12052096 | Unable to update the price for SKUs with no warehouse. Assign a warehouse and try again. | | 12052104 | property is required | | 12052105 | required qualification miss | | 12052116 | product package size is invalid | | 12052128 | Size chart not found | | 12052142 | no permission of multi global warehouse | | 12052143 | sku warehouse must equal | | 12052200 | brand is expired | | 12052201 | You are not authorized to sell this brand in this category. To do so, apply through the Qualification Center in Seller Center. | | 12052208 | A brand authorization is required to publish this listing. | | 12052217 | All region shops must use V2 categories. Check the documentation for further details. | | 12052220 | This category is prohibited or unsupported on TikTok Shop. Select another category. | | 12052221 | Only whitelisted sellers are permitted to trade under current category | | 12052222 | category do not support cod | | 12052225 | You are not authorized to sell in this category because it does not fall under your shop's main category. Contact your account manager for help or select another category. | | 12052226 | This category is restricted. To sell in this category, apply through the Qualification Center in Seller Center. | | 12052227 | the category is unauthorized or unavailable | | 12052230 | Category version and categoryID are not matched. | | 12052240 | Do not support custom property. | | 12052241 | attribute name or attribute id is empty. | | 12052242 | The attribute name characters cannot exceed max_limit | | 12052243 | The product attribute or sale attribute name characters contain Chinese. | | 12052244 | The attribute name duplicate. | | 12052245 | The product attributes contained invalid characters. Please modify and re-submit. | | 12052246 | The {{property_type}} not support multi selected, attribute id is :{{property_id}}. | | 12052247 | Do not support custom product attribute. | | 12052248 | The {{property_type}} value name or attribute value id is empty. | | 12052249 | The {{property_type}} value name characters cannot exceed {{max_limit}}, attribute value name is :{{property_value_name}}. | | 12052250 | The {{property_type}} value name characters contain Chinese. | | 12052251 | Duplicated attribute values found for an attribute. Remove or modify the duplicated value. | | 12052254 | Duplicate attribute id | | 12052260 | The product ID does not exist | | 12052261 | product name is empty | | 12052262 | Chinese characters are not supported in product name | | 12052266 | The product name contains non-English characters. | | 12052282 | Product manufacturer is required. | | 12052285 | Manufacturer ID {{manufacturer_id}} is not associated with the seller | | 12052287 | Product responsible person is required | | 12052288 | The number of responsible person ids cannot exceed {{max_limit}}, and cannot less {{min_limit}}. | | 12052290 | Responsible person ID {{rp_id}} is not associated with the seller | | 12052293 | When identifier code is not filled in, extra identification code is not allowed to be filled in. | | 12052295 | Duplicate manufacturer IDs associated with the same product | | 12052296 | Duplicate responsible person IDs associated with the same product | | 12052300 | product main image uri illegal | | 12052301 | Width and length of main image must be at least {{min_limit}}, check uri {{uri}} | | 12052302 | The main images size exceed limit. | | 12052304 | Main product image format not support. | | 12052305 | The main images aspect ratio cannot exceed max limit. | | 12052306 | main product images count exceed limit | | 12052324 | Product description image file format is not supported | | 12052340 | product description image uri illegal | | 12052341 | The description images size cannot exceed limit. | | 12052342 | The description images space cannot exceed limit. | | 12052343 | Product description image format not support. | | 12052344 | The product description html syntax with error | | 12052345 | The product description html tag not support. | | 12052346 | The product description has Chinese characters | | 12052348 | The product description html tag required attribute is miss. | | 12052349 | The product description html tag not support nest. | | 12052350 | The product description html tag contain illegal attribute. | | 12052351 | The product description contains non-English characters. | | 12052352 | The product description nest exceeding limit | | 12052360 | The video id is not exist. | | 12052401 | package weight exceed limit. | | 12052520 | product sale property image uri illegal | | 12052521 | The sale property images size over limit. | | 12052522 | Product sale property image is required | | 12052523 | Product sale property image format not support. | | 12052524 | The sale property image aspect ratio invalid | | 12052525 | The attribute max num cannot exceed 3. | | 12052526 | The attribute value max num over limit. | | 12052527 | The sale attribute id not exist. | | 12052528 | You can add images to only 1 product variation, which will serve as the primary variation for display in the product options gallery. | | 12052529 | The property value id not exist. | | 12052530 | The warehouse ' {{warehouse ID}} ' does not belong to this shop/seller. | | 12052531 | The warehouse is disabled. | | 12052550 | SKU property must contain all properties | | 12052554 | sku name contain Chinese characters | | 12052570 | product price exceed limit | | 12052574 | unit price config is invalid | | 12052591 | Invalid number of digits of identifier code | | 12052592 | Identifier code already entered, cannot enter the same code twice | | 12052598 | Only the last digit supports input X | | 12052600 | The identifier code type must be selected | | 12052650 | product qualification image uri illegal | | 12052656 | qualification id duplicate | | 12052657 | qualification image and pdf file is out of limit. | | 12052670 | The size chart image URI is invalid. Note: API users must use the URI generated by the Upload Product Image API. | | 12052671 | The sizechart images size over limit. | | 12052673 | Product sizechart image is required | | 12052700 | The seller is inactive. | | 12052701 | do not support cross-boarder seller create local product directly | | 12052702 | seller does not support pre-order | | 12052703 | Invalid seller tax number | | 12052704 | seller id not exist | | 12052910 | Invalid input parameters. Refer to the API documentation for details. | Is this content helpful?Helpful Not Helpful PreviousNext |